API reference

Upload a project file

POST/v1/projects/{projectId}/files

Authorization

Send a personal API key or an OAuth access token as Authorization: Bearer <token>.

OAuth scopes: projects:write and files:write

Parameters

projectIdstring (uuid), pathrequired

Request body

multipart/form-data, required

filestring (binary)required

Responses

201Success

fileobjectrequired
idstringrequired
versionIdstring (uuid)
namestringrequired
mediaTypestringrequired
sizenumberrequired
taskIdstring | nullrequired
projectIdstring | nullrequired
downloadUrlstring (uri)required
createdAtstringrequired
updatedAtstringrequired

400Invalid request

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

401Missing or invalid Bearer credential

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

402Payment or subscription required

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

403Credential is missing a required scope

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

404Resource not found

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

409Request conflict

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

429Rate limit exceeded

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

500Internal API error

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

curl --request POST \
  --url 'https://api.staging.adam.new/v1/projects/{projectId}/files' \
  --header 'Authorization: Bearer <token>' \
  --form 'file=@./part.step'

{
  "file": {
    "id": "<string>",
    "versionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "mediaType": "<string>",
    "size": 123,
    "taskId": "<string>",
    "projectId": "<string>",
    "downloadUrl": "https://example.com",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}