Create Upload | OnePin

curl -X POST https://api.onepin.ai/api/v1/uploads \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "filename": "automation_script_v2.py",
  "category": "script"
}'

{
  "data": {
    "upload": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "filename": "automation_script_v2.py",
      "category": "script",
      "content_type": "text/x-python",
      "status": "pending",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z",
      "workspace_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "format": "py",
      "size_bytes": 2048,
      "download_url": "https://cdn.onepin.ai/uploads/3fa85f64-5717-4562-b3fc-2c963f66afa6/download",
      "context_type": "project",
      "context_id": "9f8e7d6c-5b4a-3c2d-1e0f-9a8b7c6d5e4f"
    },
    "upload_url": "https://storage.onepin.ai/presigned/3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "meta": {
    "request_id": "req_1234567890abcdef",
    "timestamp": "2024-01-15T09:30:00Z"
  }
}

Request a presigned URL for uploading a file.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Request

This endpoint expects an object.

filenamestringRequired1-255 characters

categoryenumRequired

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error

Authentication

Headers

Request

Response

Errors