DELETE/v1/videos/{video_id}

Delete a video

Deletes a finished job and its stored video. A job still running answers 400 video_in_progress.

Authentication: Bearer API key in the Authorization header

Path parameters

  • video_idstringrequired

    The video job id.

Responses

  • 200

    Deleted.

    Response
    • idstring
    • objectstring
    • deletedboolean
  • 400

    Invalid request. param names the field; code says why (invalid_parameter, unsupported_parameter, unsupported_capability, refusal, previous_response_not_found). Not charged.

    Response
    • errorobject
      error
      • messagestring

        What went wrong and how to fix it.

      • typestring

        For example invalid_request_error, authentication_error, permission_error, rate_limit_error, insufficient_quota, api_error.

      • codestring

        The stable error code.

      • paramstring | null

        The request field at fault, when there is one.

      • refusal_reasonenum

        Present only on code: refusal.

        "cyber_policy""cbrn""content_policy""recitation""data_inspection""unspecified"
  • 401

    The key is missing, malformed, expired or revoked.

    Response
    • errorobject
      error
      • messagestring

        What went wrong and how to fix it.

      • typestring

        For example invalid_request_error, authentication_error, permission_error, rate_limit_error, insufficient_quota, api_error.

      • codestring

        The stable error code.

      • paramstring | null

        The request field at fault, when there is one.

      • refusal_reasonenum

        Present only on code: refusal.

        "cyber_policy""cbrn""content_policy""recitation""data_inspection""unspecified"
  • 404

    No such resource for this key.

    Response
    • errorobject
      error
      • messagestring

        What went wrong and how to fix it.

      • typestring

        For example invalid_request_error, authentication_error, permission_error, rate_limit_error, insufficient_quota, api_error.

      • codestring

        The stable error code.

      • paramstring | null

        The request field at fault, when there is one.

      • refusal_reasonenum

        Present only on code: refusal.

        "cyber_policy""cbrn""content_policy""recitation""data_inspection""unspecified"

Request

curl -X DELETE https://api.experientiallabs.ai/v1/videos/video_4e8a1c7b2f9d4053a6e1b8c3d7f2a910 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "video_4e8a1c7b2f9d4053a6e1b8c3d7f2a910",
  "object": "video.deleted",
  "deleted": true
}

https://api.experientiallabs.ai/v1/videos/video_4e8a1c7b2f9d4053a6e1b8c3d7f2a910