Platform Integration API Reference CLI Benchmarks

Jobs

Get job files

Retrieve all files associated with a specific job

GET

/api/jobs/{jobId}/files

Authorization

Authorization

header

string

required

Enter the project access token with the Bearer prefix, e.g. "Bearer project_access_token"

Path Parameters

jobId

string

required

Job ID

Responses

application/json

data

object[]

required

status

"success"

string

required

Status indicates the response status "success"

OK

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Authentication error: invalid token or subscription inactive

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Resource not found

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Rate limit exceeded

import Chunkify from '@chunkify/chunkify';

const client = new Chunkify({
  projectAccessToken: 'My Project Access Token',
});

const files = await client.jobs.files.list('jobId');

console.log(files);
from chunkify import Chunkify

client = Chunkify(
    project_access_token="My Project Access Token",
)
files = client.jobs.files.list(
    "jobId",
)
print(files)
<?php

use Chunkify\Client;

$client = new Client(
    projectAccessToken: 'My Project Access Token',
);

$files = $client->jobs->files->list('jobId');

var_dump($files);
package main

import (
  "context"
  "fmt"

  "github.com/chunkifydev/chunkify-go"
  "github.com/chunkifydev/chunkify-go/option"
)

func main() {
  client := chunkify.NewClient(
    option.WithProjectAccessToken("My Project Access Token"),
  )
  files, err := client.Jobs.Files.List(context.TODO(), "jobId")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", files)
}

{
  "data": [
    {
      "audio_bitrate": 128000,
      "audio_codec": "aac",
      "created_at": "2025-01-01T12:00:00Z",
      "duration": 120,
      "height": 1080,
      "id": "file_2G6MJiNz71bHQGNzGwKx5cJwPFS",
      "job_id": "job_2G6MJiNz71bHQGNzGwKx5cJwPFS",
      "mime_type": "video/mp4",
      "path": "path/to/file.mp4",
      "size": 1234567,
      "storage_id": "stor_chunkify_2wLmj1fp8neUaFAWwwxvzKAT0Fa",
      "url": "https://my-bucket.s3.us-east-1.amazonaws.com/path/to/file.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256",
      "video_bitrate": 20000000,
      "video_codec": "h264",
      "video_framerate": 29.97,
      "width": 1920
    }
  ],
  "status": "success"
}
{
  "error": {
    "code": 401,
    "message": "Authentication error: invalid token or subscription inactive",
    "type": "AuthenticationError"
  },
  "status": "error"
}
{
  "error": {
    "code": 404,
    "message": "Ressource not found",
    "type": "NotFoundError"
  },
  "status": "error"
}
{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "TooManyRequestsError"
  },
  "status": "error"
}

# Get job files > Retrieve all files associated with a specific job ```json { "path": "/api/jobs/{jobId}/files", "method": "get", "schema": { "description": "Retrieve all files associated with a specific job", "operationId": "getJobFiles", "parameters": [ { "description": "Job ID", "in": "path", "name": "jobId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobFilesListResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseErrorAuthentication" } } }, "description": "Authentication error: invalid token or subscription inactive" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseErrorNotFound" } } }, "description": "Resource not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseErrorTooManyRequests" } } }, "description": "Rate limit exceeded" } }, "security": [ { "ProjectAccessToken": [] } ], "summary": "Get job files", "tags": [ "Jobs" ], "x-codeSamples": [ { "lang": "JavaScript", "source": "import Chunkify from '@chunkify/chunkify';\n\nconst client = new Chunkify({\n projectAccessToken: 'My Project Access Token',\n});\n\nconst files = await client.jobs.files.list('jobId');\n\nconsole.log(files);" }, { "lang": "Python", "source": "from chunkify import Chunkify\n\nclient = Chunkify(\n project_access_token=\"My Project Access Token\",\n)\nfiles = client.jobs.files.list(\n \"jobId\",\n)\nprint(files)" }, { "lang": "php", "source": "\u003c?php\n\nuse Chunkify\\Client;\n\n$client = new Client(\n projectAccessToken: 'My Project Access Token',\n);\n\n$files = $client-\u003ejobs-\u003efiles-\u003elist('jobId');\n\nvar_dump($files);" }, { "lang": "Go", "source": "package main\n\nimport (\n \"context\"\n \"fmt\"\n\n \"github.com/chunkifydev/chunkify-go\"\n \"github.com/chunkifydev/chunkify-go/option\"\n)\n\nfunc main() {\n client := chunkify.NewClient(\n option.WithProjectAccessToken(\"My Project Access Token\"),\n )\n files, err := client.Jobs.Files.List(context.TODO(), \"jobId\")\n if err != nil {\n panic(err.Error())\n }\n fmt.Printf(\"%+v\\n\", files)\n}\n" } ] } } ``` ```json #/components/schemas/JobFilesListResponse { "description": "Response containing a list of files for a job", "properties": { "data": { "items": { "$ref": "#/components/schemas/File" }, "type": "array" }, "status": { "const": "success", "description": "Status indicates the response status \"success\"", "type": "string" } }, "required": [ "status", "data" ], "type": "object" } ``` ```json #/components/schemas/File { "properties": { "audio_bitrate": { "description": "Audio bitrate in bits per second", "examples": [ 128000 ], "type": "integer" }, "audio_codec": { "description": "Audio codec used", "examples": [ "aac" ], "type": "string" }, "cdn_url": { "description": "Stable, unsigned CDN delivery URL derived from the file's current storage configuration. Omitted when no CDN base URL is configured.", "examples": [ "https://media.example.com/path/to/file.mp4" ], "format": "uri", "nullable": true, "type": "string" }, "created_at": { "description": "Timestamp when the file was created", "examples": [ "2025-01-01T12:00:00Z" ], "format": "date-time", "type": "string" }, "duration": { "description": "Duration of the video in seconds", "examples": [ 120 ], "type": "integer" }, "height": { "description": "Height of the video in pixels", "examples": [ 1080 ], "type": "integer" }, "id": { "description": "Unique identifier of the file", "examples": [ "file_2G6MJiNz71bHQGNzGwKx5cJwPFS" ], "type": "string" }, "job_id": { "description": "ID of the job that created this file", "examples": [ "job_2G6MJiNz71bHQGNzGwKx5cJwPFS" ], "type": "string" }, "mime_type": { "description": "MIME type of the file", "examples": [ "video/mp4" ], "type": "string" }, "path": { "description": "Path to the file in storage", "examples": [ "path/to/file.mp4" ], "type": "string" }, "size": { "description": "Size of the file in bytes", "examples": [ 1234567 ], "type": "integer" }, "storage_id": { "description": "StorageId identifier where the file is stored", "examples": [ "stor_chunkify_2wLmj1fp8neUaFAWwwxvzKAT0Fa" ], "type": "string" }, "url": { "description": "Pre-signed URL to directly access the file (only included when available)", "examples": [ "https://my-bucket.s3.us-east-1.amazonaws.com/path/to/file.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256" ], "type": "string" }, "video_bitrate": { "description": "Video bitrate in bits per second", "examples": [ 20000000 ], "type": "integer" }, "video_codec": { "description": "Video codec used", "examples": [ "h264" ], "type": "string" }, "video_framerate": { "description": "Video framerate in frames per second", "examples": [ 29.97 ], "type": "number" }, "width": { "description": "Width of the video in pixels", "examples": [ 1920 ], "type": "integer" } }, "required": [ "id", "job_id", "storage_id", "path", "size", "mime_type", "duration", "width", "height", "video_bitrate", "video_codec", "video_framerate", "audio_codec", "audio_bitrate", "created_at", "url" ], "type": "object" } ``` ```json #/components/schemas/ResponseErrorAuthentication { "description": "Error response", "properties": { "error": { "description": "Error response details", "properties": { "code": { "const": 401, "description": "Code is the HTTP status code", "examples": [ 401 ], "type": "integer" }, "message": { "description": "Message is a human-readable error description", "examples": [ "Authentication error: invalid token or subscription inactive" ], "type": "string" }, "type": { "const": "AuthenticationError", "description": "Type indicates the error category", "enum": [ "AuthenticationError" ], "type": "string" } }, "required": [ "type", "code", "message" ], "type": "object" }, "status": { "const": "error", "description": "Status indicates the response status \"error\"", "type": "string" } }, "required": [ "status", "error" ], "type": "object" } ``` ```json #/components/schemas/ResponseErrorNotFound { "description": "Error response", "properties": { "error": { "description": "Error response details", "properties": { "code": { "const": 404, "description": "Code is the HTTP status code", "examples": [ 404 ], "type": "integer" }, "message": { "description": "Message is a human-readable error description", "examples": [ "Ressource not found" ], "type": "string" }, "type": { "const": "NotFoundError", "description": "Type indicates the error category", "enum": [ "NotFoundError" ], "type": "string" } }, "required": [ "type", "code", "message" ], "type": "object" }, "status": { "const": "error", "description": "Status indicates the response status \"error\"", "type": "string" } }, "required": [ "status", "error" ], "type": "object" } ``` ```json #/components/schemas/ResponseErrorTooManyRequests { "description": "Error response", "properties": { "error": { "description": "Error response details", "properties": { "code": { "const": 429, "description": "Code is the HTTP status code", "examples": [ 429 ], "type": "integer" }, "message": { "description": "Message is a human-readable error description", "examples": [ "Rate limit exceeded" ], "type": "string" }, "type": { "const": "TooManyRequestsError", "description": "Type indicates the error category", "enum": [ "TooManyRequestsError" ], "type": "string" } }, "required": [ "type", "code", "message" ], "type": "object" }, "status": { "const": "error", "description": "Status indicates the response status \"error\"", "type": "string" } }, "required": [ "status", "error" ], "type": "object" } ```