Create a logo

You can create a logo here with a url or an uploaded media id. See Upload Media. Allowed production methods are for DTG and Manual processing.

Background processing

When you create a logo, this happens asynchronously, and you have to use Polling or Webhooks. You will receive the new logo id in the header for later reference.

The current state of the asynchronous process is represented due following states:

State	Meaning
`draft`	The initial state of a new logo.
`checking`	Logo is processed automatically in background. For example images will be generated or downloaded.
`failed`	Something went wrong during the checking process. The reason can be found in the `failure_message` attribute. For example an image could not be downloaded.
`completed`	All automatic processes were successful. The logo is ready to use.

It is not possible to use this logo before state completed.

Media Array / Media Object

The request field media is always an array of media objects — see the media property of the request body.

Production Method Object

For a list of available production methods see Production Methods — see the production_method property of the request body.

AuthorizationbearerAuth

Authorization

bearerAuth

AuthorizationBearer <token>

API token as bearer token — you receive a test and a live token, there is no switch between them. See Setup → Authentication and Setup → Test mode.

In: header

Header Parameters

Accept*"application/json"

The API only responds with JSON — this header is mandatory on every request (see Setup → Headers).

Default"application/json"

Value in

"application/json"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Create a logo with a url or an uploaded media id (see Upload Media). Allowed production methods are for DTG and Manual processing.

production_method*

Production Method Object — for a list of available production methods see Production Methods.

Field	Type	Description	Required
`id`	int	The production methods id.	yes*
`handle`	string	The production method handle which is defined by the producer.	yes*

* You have to choose exactly one of id or handle.

media*array<>

Media Array / Media Object — the request field media is always an array of media objects.

Field	Type	Description	Required
`collection_name`	string	Unique identifier for the intended use. Allowed name is `production-file`.	yes
`id`	int	Use this `id` if you want to use an existing Media from your uploads. See Media.	yes*
`url`	string	Url which references a file. This file will be downloaded and attached to the resource.	yes*

* You have to choose exactly one of id or url.

Response Body

`application/json`

Request example

curl -X POST "https://example.com/logos" \  -H "Accept: application/json" \  -H "Content-Type: application/json" \  -d '{    "production_method": {      "handle": "dtg"    },    "media": [      {        "url": "https://smake-public.s3.eu-west-1.amazonaws.com/testfiles/logo.png",        "collection_name": "production-file"      }    ]  }'

Empty

Create a logo

Background processing

Media Array / Media Object

Production Method Object

Authorization

Header Parameters

Request Body

Response Body

202

401application/json

422application/json

`application/json`

`application/json`