Pictory
  1. API Reference
Pictory
  • API Flows
    • Text to Video API Flow
      • Step 1: Authenticate
      • Step 2: Generate Video Preview from Text
      • Step 3: GET Video Preview & Default Settings
      • Step 4: Render Video
      • Step 4: Render PUT
      • Step 5: GET Video Download URL
    • Video Editing API Flow
      • Step 1: Authenticate
      • Step 2: Obtain Pictory Upload URL
      • Step 3: Upload video to Pictory
      • Step 4: v2 Transcribe Uploaded Video
      • Step 5: GET Default Transcription & Highlights Settings
      • Step 6: Render Video
      • Step 7: GET Video Download URL
    • Bulk Video Generation APIs
      • Step 1: Authenticate
      • Step2: Upload Project
      • Step3: Update Variables
      • Step 4: Get Video Preview
      • Step 5: Render Video
      • Step 6: GET Video Download URL
  • API Reference
    • /v1/oauth2/token
      POST
    • /v1/video/storyboard
      POST
    • /v1/job/{job_id}
      GET
    • /v1/media/generateUrl
      POST
    • Upload video to Pictory
      PUT
    • /v2/transcription (Transcript & Highlights)
      POST
    • /v2 GET Default Transcription & Highlights Settings
      GET
    • /v1/transcription
      POST
    • /v1 GET Default Transcription Settings
      GET
    • /v1/transcription/highlights
      POST
    • /v2/transcription/highlights
      POST
    • /v1 GET Default Highlight Settings
      GET
    • /v1/video/storyboard/fonts
      GET
    • Create Template
      POST
    • Update Template
      PUT
    • Get Templates
      GET
    • Create Template Video
      POST
    • Get Template By Id
      GET
    • Delete Template By Id
      DELETE
    • /v1/video/render
      POST
    • v1/media/search
      GET
  1. API Reference

/v1/job/{job_id}

Develop Env
https://dev.your-api-server.com
Develop Env
https://dev.your-api-server.com
GET
/v1/jobs/{{job_id}}
The response depends on job status. View variations by selecting a response from the Example Response section's top-right dropdown.
This endpoint returns the status of the passed job_Id
This endpoint returns status for all background processing jobs such as: Generate Video Preview from Text, Transcribe Video, Render Video
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://dev.your-api-server.com/v1/jobs/{{job_id}}' \
--header 'Authorization: {{access_token}}' \
--header 'X-Pictory-User-Id: {{X-Pictory-User-Id}}'
Response Response Example
200 - v1 Job In Progress - v1 Job In Progress
{
    "job_id": "6830fe00-872b-4e96-86b5-e4b527f0295b",
    "success": true,
    "data": {
        "status": "in-progress"
    }
}

Request

Header Params
Authorization
string 
required
Example:
{{access_token}}
X-Pictory-User-Id
string 
required
Used for logging purposes
Example:
{{X-Pictory-User-Id}}

Responses

🟢200v1 Job In Progress
application/json
Body
job_id
string 
required
success
boolean 
required
data
object 
required
status
string 
required
🟢200v1 GET Default Video Settings (Text to Video API Flow)
🟢200v2 Get Default Transcription & Highlight Settings
🟢200v1 GET Default Transcription Settings (Video Editing Flow)
🟢200v1 GET Default Highlight Settings (Video Editing API Flow)
🟢200v1 GET Video Download URL (Final Step in all API Flows)
Modified at 2024-07-10 08:41:40
Previous
/v1/video/storyboard
Next
/v1/media/generateUrl
Built with