Creatives

When you start an export, the resources generated by the export are called creatives. For example, if you export a set with multiple sizes, a creative will be generated for each size from the template design you want to modify and export.

Each creative generated by an export has the type of the export (JPG, GIF, MP4…)

These resources are related strictly to the API, and you will not find them anywhere in the app, with the only specification that for each creative generated, we will have a generated design in the app.

All the status of the creatives can be seen directly from the export status, as in the next example:

{
    "response": {
        "id": "b46adaed-39df-41a2-89e5-beb870282414",
        "elementsChanges": null,
        "type": "jpg",
        "status": "complete",
        "errorLog": null,
        "creatives": [
            {
                "status": "complete",
                "url": "https://thebrief-api-0d4e56b.s3.eu-central-1.amazonaws.com/creatives/b46adaed-39df-41a2-89e5-beb870282414/fc188412-c614-4db7-b611-f725e73cb36d?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIASCU4ALRBL5EQ3KHE%2F20240911%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20240911T072944Z&X-Amz-Expires=3600&X-Amz-Signature=6739d8a7f2f70b7a518c510eb10ebcbcd82fe57dec1a0c335df473257229562e&X-Amz-SignedHeaders=host",
                "id": "fc188412-c614-4db7-b611-f725e73cb36d"
            },
            {
                "status": "complete",
                "url": "https://thebrief-api-0d4e56b.s3.eu-central-1.amazonaws.com/creatives/b46adaed-39df-41a2-89e5-beb870282414/954dad76-6dd9-4a79-ac09-26da6bceeb96?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIASCU4ALRBL5EQ3KHE%2F20240911%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20240911T072944Z&X-Amz-Expires=3600&X-Amz-Signature=bfd48ac7717f9f4cedf60aa5d3ca0f2dbf55ec202bf8ac9829465756450489ef&X-Amz-SignedHeaders=host",
                "id": "954dad76-6dd9-4a79-ac09-26da6bceeb96"
            }
        ]
    }
}

If you are interested in a specific ID of a generated creative, you can call and take the status of that creative by calling the creative endpoint.

curl --location 'https://api.thebrief.ai/v1/creative/fc188412-c614-4db7-b611-f725e73cb36d' \
--header 'Authorization: Bearer eyJ...'

Response example:

{
    "response": {
        "status": "complete",
        "url": "https://thebrief-api-0d4e56b.s3.eu-central-1.amazonaws.com/creatives/b46adaed-39df-41a2-89e5-beb870282414/fc188412-c614-4db7-b611-f725e73cb36d?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIASCU4ALRBL5EQ3KHE%2F20240911%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20240911T140349Z&X-Amz-Expires=3600&X-Amz-Signature=6d71919d3572df0321b527034b75237062fc370d4c4beb987f97bee537075b5f&X-Amz-SignedHeaders=host",
        "id": "fc188412-c614-4db7-b611-f725e73cb36d"
    }
}

Another scenario when this can be useful is if you need to take the creative URL after more than a day; the provided URL is available for only one hour. But if you call this again after that period, another one-hour valid URL is provided.