Designs

List only designs (not templates)

List all designs (not templates) you have access to with the user assigned to the credentials.

This endpoint makes an HTTP GET request to retrieve a list of designs from the specified API endpoint.

Request

• Method: GET

• Endpoint: https://api.creatopy.com/v1/designs

• Query Parameters:

  • keyword (string, optional): The keyword to search for a design name

  • projectId (integer, optional): Return only designs from a project

  • limit (integer, optional): The maximum number of designs to be returned.

  • cursor (string, optional): A cursor for pagination.

  • apiGenerated (boolean, optional): Return only designs generated by API (excluded without this true)

  • orderBy (enum, optional): option to order the response results by next fields:

    ID
    NAME
    CREATED_AT
    UPDATED_AT

  • orderDirection (enum, optional): option to order the response by direction:

    ASC
    DESC

Response

Upon a successful execution with a status code of 200, the response will be in JSON format and will include a "response" object containing an array of "nodes" with "id" and "name" properties, as well as a "pageInfo" object with "hasNextPage" and "endCursor" properties.

Request example:

{
    "response": {
        "nodes": [
            {
                "id": "3pqqql",
                "name": "Untitled design",
                "projectId": 826801,
                "apiGenerated": false,
            },
            {
                "id": "lwp7dy",
                "name": "Untitled design",
                "projectId": 826801,
                "apiGenerated": false,
            },
            {
                "id": "m0rg1n",
                "name": "Car test",
                "projectId": 826801,
                "apiGenerated": false,
            },
            ...
            {
                "id": "q8lx0r",
                "name": "Zapi temp 2 - long name here for testing",
                "projectId": 826801,
                "apiGenerated": false,
            },
            {
                "id": "jdeglo",
                "name": "Zapi temp_300x250px_Fri Sep 01 2023 copy",
                "projectId": 826801,
                "apiGenerated": false,
            },
            {
                "id": "mexkl7",
                "name": "Zapi temp_300x250px_Mon Sep 04 2023",
                "projectId": 826801,
                "apiGenerated": true,
            },
            {
                "id": "ydk1lz",
                "name": "Zapi temp",
                "projectId": 826801,
                "apiGenerated": false,
            },
        ],
        "pageInfo": {
            "hasNextPage": true,
            "endCursor": "eyJsaW1pdCI6NTAsImxhc3RJZCI6MzEzNDI0Mn0="
        }
    }
}