town.delve.video.getUploadStatus

delve.town

Documentation

Get the authoritative status of the upload phase. Terminal states remain readable. completedJobId and jobStatus are present only for completed sessions; failureReason is present only for failed sessions.

main query

Get the authoritative status of the upload phase. Terminal states remain readable. completedJobId and jobStatus are present only for completed sessions; failureReason is present only for failed sessions.

Parameters

jobId string Required

No description available.

Output

Encodingapplication/json
completedJobId string Optional

Present only when state is completed; may differ from jobId on deduplication.

expiresAt stringdatetime Required

An RFC 3339 formatted timestamp.

failureReason string Optional

Present only when state is failed.

jobId string Required

No description available.

partCount integer Required

No description available.

partSizeBytes integer Required

No description available.

receivedParts array Required

No description available.

state string Required

No description available.

Known values: created, finishing, completed, failed, aborted, expired

Errors

UploadNotFound The job ID is unknown or aged out of retention; known terminal sessions remain readable and are never reported as not found.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
View raw schema
{
  "description": "Get the authoritative status of the upload phase. Terminal states remain readable. completedJobId and jobStatus are present only for completed sessions; failureReason is present only for failed sessions.",
  "errors": [
    {
      "description": "The job ID is unknown or aged out of retention; known terminal sessions remain readable and are never reported as not found.",
      "name": "UploadNotFound"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "completedJobId": {
          "description": "Present only when state is completed; may differ from jobId on deduplication.",
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        "expiresAt": {
          "format": "datetime",
          "type": "string"
        },
        "failureReason": {
          "description": "Present only when state is failed.",
          "maxLength": 1024,
          "type": "string"
        },
        "jobId": {
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        "jobStatus": {
          "description": "Present only when state is completed.",
          "ref": "town.delve.video.defs#jobStatus",
          "type": "ref"
        },
        "partCount": {
          "type": "integer"
        },
        "partSizeBytes": {
          "type": "integer"
        },
        "receivedParts": {
          "items": {
            "minimum": 1,
            "type": "integer"
          },
          "type": "array"
        },
        "state": {
          "knownValues": [
            "created",
            "finishing",
            "completed",
            "failed",
            "aborted",
            "expired"
          ],
          "maxLength": 32,
          "type": "string"
        }
      },
      "required": [
        "jobId",
        "partSizeBytes",
        "partCount",
        "receivedParts",
        "expiresAt",
        "state"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "jobId": {
        "maxLength": 256,
        "minLength": 1,
        "type": "string"
      }
    },
    "required": [
      "jobId"
    ],
    "type": "params"
  },
  "type": "query"
}

Lexicon Garden

@