Error Reference

Auto-generated from CLI and API source code. Do not edit manually. Regenerate with: npx tsx scripts/generate-error-catalog.ts

41 error kinds across CLI and API.

Summary

Category	Count
Authentication	3
Required Input	3
Validation	7
Not Found	3
Conflict	3
Processing	12
Storage	6
Other	4

Authentication

Kind	Origin	Message
org_paused	API	This organisation is paused
token_invalid	API	The API key is invalid or has been revoked
token_missing	API	Authorization header is required

Required Input

Kind	Origin	Message
input_required	CLI	-i is required. Provide a JSON source object.
missing_flag	CLI	—name is required
output_required	CLI	-o is required for step commands.

Validation

Kind	Origin	Message
invalid_input	CLI	cannot create animated image from an audio file
invalid_kind	CLI	unknown task kind: %s
invalid_mimetype	CLI	not a media file (Content-Type: %s): %s
invalid_output	CLI	invalid output path: %s
invalid_source	CLI	cannot determine media kind from source data — include a ‘kind’ field (video, au…
invalid_url	CLI	invalid URL: %s
invalid_usage	CLI	—limit must be between 1 and 100

Not Found

Kind	Origin	Message
file_not_found	CLI	file not found: %s
not_found	CLI, API	connection ‘%s’ not found
task_not_found	API	The task does not exist

Conflict

Kind	Origin	Message
duplicate_name	CLI	connection ‘%s’ already exists
format_conflict	CLI	—format %s conflicts with output extension ‘%s’. Remove one or make them match
output_exists	CLI	output path is the same as input: %s. Choose a different path with -o

Processing

Kind	Origin	Message
api_error	CLI	failed to reach API: %v
clean_error	CLI	cannot determine working directory
config_error	CLI	failed to load connections: %v
dispatch_error	API	Failed to dispatch step to processor
download_error	API	404 not found
download_failed	CLI	cannot download: %s
encode_failed	CLI	cannot determine working directory
internal_error	API	An unexpected error occurred
log_error	CLI	cannot determine working directory
processing_error	API	codec not supported
request_failed	CLI	cannot reach URL: %s
timeout	CLI	task did not complete within timeout

Storage

Kind	Origin	Message
missing_connection	CLI	no connections configured. Run: ittybit connections add s3 —name —endpo…
s3_access_denied	CLI	access denied: check IAM permissions for %s
s3_auth_error	CLI	invalid credentials: check access key ID and secret access key
s3_error	CLI	failed to create S3 provider: %v
s3_not_found	CLI	not found: %s
s3_throttled	CLI	S3 rate limited or temporarily unavailable: try again

Other

Kind	Origin	Message
cloud_not_supported	CLI	step commands run locally. Use ittybit —cloud for remote execution.
file_access_denied	CLI	cannot access file: %s
internal	CLI	failed to marshal task spec: %v
request_invalid	API	At least one of task_id or step_id is required