Register an asset
const url = 'https://ads.wortise.com/api/public/v1/assets/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = { method: 'PUT', headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'}, body: '{"aspectRatio":"16:9","brand":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","campaign":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","extension":"png","filename":"example","name":"example","size":1,"type":"image","url":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://ads.wortise.com/api/public/v1/assets/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Content-Type: application/json' \ --header 'x-api-key: <x-api-key>' \ --data '{ "aspectRatio": "16:9", "brand": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "campaign": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "extension": "png", "filename": "example", "name": "example", "size": 1, "type": "image", "url": "example" }'Registers an uploaded media file in the asset library with the caller-generated id. Send as url the url that POST /assets/{id}/upload-url returned: without it the asset has no file to show.
Requires the assets:write scope.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Caller-generated asset UUID v4, the same used for the upload URL.
Request Bodyrequired
Section titled “Request Bodyrequired”object
object
object
object
Responses
Section titled “Responses”The registered asset.
object
Example
{ "aspectRatio": "16:9", "extension": "png", "locale": "en", "type": "image"}The JSON body is malformed or fails the input validation.
object
Zod issues
object
Location of the invalid field in the procedure input
object
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "errors": [ { "code": "custom" } ], "message": "Validation Error"}The API key is missing, invalid, disabled or expired.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The API key lacks the scope, or its owner lacks the dashboard permission.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The resource does not exist in the organization of the API key.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The request conflicts with the resource state.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The API key exceeded its rate limit; retry after the Retry-After seconds.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}Headers
Section titled “Headers”Seconds to wait before retrying.
Unexpected server error.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}© 2026 Wortise. All rights reserved.