Jobs

Assign tag to output image

PUT
/jobs/{job_id}/outputs/{image_index}/tags

Additively assign tags to a specific output image version (default: the latest version; pass ?version= to target an older one). Tags are bound to that version only and do not carry over to a future regenerate/retouch version.

Authorization

token_auth
headerAuthorizationBearer <token>

Token-based authentication using access tokens.

Path Parameters

job_id*string
image_index*integer
Formatint32

Query Parameters

group_index?Group Index
Default0
version?|
Defaultnull

Request Body

application/json
  1. body
tag_ids?array<string>

IDs of existing tags to assign.

Default[]
new_tags?array<>

New tags to create and assign in the same call.

Default[]

Response Body

Successful Response

application/json
  1. response
tags*array<>

All tags currently assigned to this image version.

curl -X PUT "https://example.com/jobs/string/outputs/0/tags" \  -H "Content-Type: application/json" \  -d '{}'
{  "tags": [    {      "id": "string",      "name": "string",      "color": "string",      "created_by": "string",      "created_at": "string",      "asset_count": null,      "preview_thumbnails": null    }  ]}