VIvideogen
Tools

List tool executions

Changed on

List tool executions started via the API, most recently created first. Use selfOnly=true to restrict results to the calling API key's user; otherwise all executions for the team are returned. Cursor-paginated; see the Pagination guide. Executions remain listable indefinitely (including those older than 7 days). For efficiency this list does not re-sign result download URLs, so downloadUrl/thumbnailUrl reflect the last time they were signed and may be expired (always check downloadUrlExpiresAt). To obtain a fresh signed URL, GET the individual execution (GET /v1/tools/executions/{toolExecutionId}) or hydrate the file (GET /v1/files/{fileId} / POST /v1/files/{fileId}/hydrate).

get/v1/tools/executions

Request

  • Base URL
    https://api.videogen.io
  • Auth
    HTTP bearer

Query parameters

limitinteger

Maximum number of items to return in the page. Defaults to 50; capped at 200. See Pagination.

cursorstring

Opaque pagination cursor returned as nextCursor by the previous page. Omit on the first request. Cursors are tied to the endpoint that produced them and must be passed unmodified. See Pagination.

selfOnlyboolean

When true, returns only items created by the API key's owner. When false (default), returns all items accessible to the team.

Response

Paginated list of tool executions.

hasMoreboolean required

When true, there are more executions available. Pass nextCursor as the cursor query param to fetch the next page.

nextCursorstring nullable required

Opaque cursor to fetch the next page. null when hasMore is false.

Changes

  • f717ffcc857bRevision changes
    • breaking

      the // response's property type changed from string to no type for status

    • info

      added subschema #2 to the // response property anyOf list for the response status

    • info

      removed the cancelled enum value from the // response property for the response status

    • info

      removed the failed enum value from the // response property for the response status

    • info

      removed the pending enum value from the // response property for the response status

    • info

      removed the running enum value from the // response property for the response status

    • info

      removed the succeeded enum value from the // response property for the response status