Skip to content

/v1/catalog-imports/drafts/{draftId}/parts/{section}/{part}

PUT
/v1/catalog-imports/drafts/{draftId}/parts/{section}/{part}
curl --request PUT \
--url https://api.emely.io/v1/catalog-imports/drafts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/parts/parties/1 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "items": [ { "additionalProperty": "example" } ] }'

Store one part of the import document via the addCatalogImportDraftPart Action. A part is at most 64 KB of items of one section; re-sending the same (section, part) replaces it. A refused part returns 200 with ok:false and the errors listed. Requires an api_operator token.

draftId
required
string format: uuid
section
required
string
Allowed values: parties works recordings products unmapped
part
required
integer
>= 1
Media typeapplication/json
object
items
required
Array<object>
object
key
additional properties
Examplegenerated
{
"items": [
{
"additionalProperty": "example"
}
]
}

Whether the part was stored, plus any validation errors

Media typeapplication/json
object
ok
required
boolean
bytes
required
integer
errors
required
Array<object>
object
section
required
string | null
path
required
string
message
required
string
sourceRow
Examplegenerated
{
"ok": true,
"bytes": 1,
"errors": [
{
"section": "example",
"path": "example",
"message": "example",
"sourceRow": "example"
}
]
}

Validation refused by the Action

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

Missing or invalid bearer token

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

Token role refused for this route

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

Import draft not found

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

Upstream error

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}