Submitter API Documentation

curl -s https://api.glymt.com/upload/v1

{
  "name": "Glymt Submitter API",
  "version": "1.0",
  "documentation": "https://glymt.com/submitter_api_documentation",
  "description": "{summary}"
}

curl -s -X POST https://api.glymt.com/upload/v1/oauth/token \
  -u '{client_id}:{client_secret}' \
  -d grant_type=client_credentials

{
  "access_token": "{access_token}",
  "token_type": "Bearer",
  "expires_in": 7200,
  "scope": "upload"
}

curl -s -X POST https://api.glymt.com/upload/v1/batches/open \
  -H 'Authorization: Bearer {access_token}'

HTTP/1.1 201 Created

{
  "batch_id": "{batch_id}",
  "upload_url": "/upload/v1/batches/upload_url/{batch_id}",
  "submit": "/upload/v1/batches/submit/{batch_id}"
}

HTTP/1.1 429 Too Many Requests

{ "error": "monthly_ceiling", "reset_at": "2026-11-01T00:00:00Z" }

curl -s -X POST https://api.glymt.com/upload/v1/batches/upload_url/{batch_id} \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{ "kind": "video", "filename": "beach_sunset_01.mp4", "size": 734003200, "content_type": "video/mp4" }'

{
  "batch_id": "{batch_id}",
  "kind": "video",
  "file": "beach_sunset_01.mp4",
  "method": "PUT",
  "url": "{presigned_upload_url}",
  "headers": { "Content-Type": "video/mp4" },
  "expires_in": 3600
}

curl -s -X PUT '{presigned_upload_url}' \
  -H 'Content-Type: video/mp4' \
  --upload-file beach_sunset_01.mp4

curl -s -X POST https://api.glymt.com/upload/v1/batches/submit/{batch_id} \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{
        "videos": [
          {
            "file": "beach_sunset_01.mp4",
            "title": "Sunset over the beach",
            "description": "Golden hour on a quiet beach",
            "keywords": ["beach", "sunset", "sea", "waves"],
            "categories": ["Nature", "Travel"],
            "is_ai": false,
            "submitter_video_id": "SV-0001",
            "releases": ["release_ana.pdf"],
            "publish": true
          }
        ]
      }'

{
  "batch_id": "{batch_id}",
  "accepted": 1,
  "refused": 1,
  "rows": [
    { "submitter_video_id": "SV-0001", "file": "beach_sunset_01.mp4", "result": "accepted", "reason": null, "submitted_video_id": {submission_id} },
    { "submitter_video_id": "SV-0002", "file": "city_02.mp4", "result": "refused", "reason": "file city_02.mp4 is not in the batch (upload it to its upload_url first)", "submitted_video_id": null }
  ]
}

curl -s 'https://api.glymt.com/upload/v1/videos/list?page=1&per_page=50' \
  -H 'Authorization: Bearer {access_token}'

{
  "count": {submissions},
  "page": 1,
  "per_page": 50,
  "videos": [ {Upload}, … ]
}

curl -s https://api.glymt.com/upload/v1/videos/status/SV-0001 \
  -H 'Authorization: Bearer {access_token}'

{ "video": {Upload} }

curl -s -X DELETE https://api.glymt.com/upload/v1/videos/remove/{video_id} \
  -H 'Authorization: Bearer {access_token}'

HTTP/1.1 202 Accepted

{ "video_id": {video_id}, "state": "removing" }

curl -s -X POST https://api.glymt.com/upload/v1/releases/register \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{ "batch_id": "{batch_id}", "file": "release_ana.pdf", "name": "Ana", "legal_age": "adult" }'

HTTP/1.1 202 Accepted

{ "name": "Ana", "file": "release_ana.pdf", "state": "registering", "list": "/upload/v1/releases/list" }

curl -s 'https://api.glymt.com/upload/v1/releases/list?page=1&per_page=50' \
  -H 'Authorization: Bearer {access_token}'

{
  "count": 1,
  "page": 1,
  "per_page": 50,
  "releases": [
    { "id": {release_id}, "name": "Ana", "legal_age": "adult", "videos_count": 1, "created_at": "2026-10-30T12:00:00Z" }
  ]
}

curl -s https://api.glymt.com/upload/v1/releases/details/{release_id} \
  -H 'Authorization: Bearer {access_token}'

{
  "release": {
    "id": {release_id}, "name": "Ana", "legal_age": "adult", "videos_count": 1, "created_at": "2026-10-30T12:00:00Z",
    "url": "{signed_release_url}", "expires_in": 300
  }
}

curl -s -X DELETE https://api.glymt.com/upload/v1/releases/remove/{release_id} \
  -H 'Authorization: Bearer {access_token}'

HTTP/1.1 202 Accepted

{ "release_id": {release_id}, "state": "removing" }

curl -s https://api.glymt.com/upload/v1/account/summary \
  -H 'Authorization: Bearer {access_token}'

{
  "client": { "name": "{client_name}", "client_id": "{client_id}" },
  "videos": { "submitted": 12, "processing": 1, "awaiting_approval": 2, "published": 8, "rejected": 1, "removed": 0 },
  "published_count": 8,
  "sales_count": 3,
  "earnings": 21.5,
  "unpaid_earnings": 7.25,
  "quota": {
    "tier": "{tier}",
    "month_admitted": 12,
    "monthly_ceiling": {monthly_ceiling},
    "resets_at": "2026-11-01T00:00:00Z",
    "lifetime_admitted": 12,
    "lifetime_allowance": {lifetime_allowance}
  }
}

curl -s 'https://api.glymt.com/upload/v1/account/sales?page=1&start_date=2026-10-01&end_date=2026-10-31' \
  -H 'Authorization: Bearer {access_token}'

{
  "count": 1,
  "page": 1,
  "per_page": 50,
  "sales": [
    { "video_id": {video_id}, "sold_at": "2026-10-20T15:00:00Z", "channel": "Glymt" }
  ]
}