Skip to content
Artbucket

Hand in an upload through a link

POST
/api/v1/shared/{token}/assets
curl --request POST \
  --url http://localhost:3000/api/v1/shared/example/assets \
  --header 'Content-Type: application/json' \
  --data '{ "token": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "filename": "example", "mime": "example" }'

It lands proposed, in the link’s collection. The guest learns it arrived, nothing about the library.

No key needed.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
token
required
string

From an upload link

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
token
required

From POST /api/v1/shared/{token}/uploads, after the PUT

string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
filename
required
string
>= 1 characters <= 512 characters
mime
required
string
>= 1 characters <= 255 characters
Examplegenerated
{
  "token": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "filename": "example",
  "mime": "example"
}

Responses

Section titled “Responses”

201

Section titled “201”

Received

Media typeapplication/json
object
data
required
object
received
required
boolean
deduped
required
boolean
Example
{
  "data": {
    "received": true
  }
}

default

Section titled “default”

An error

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
detail
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "detail": "example"
  }
}