Create concept

POST /data/projects/{project_id}/concepts

Create a new concept for a specific project with name, description, and optional entity concept links.

Path parameters

  • project_id Required

    Unique identifier of the project

application/json

Body Required

  • name string Required

    Concept name

  • description string

    Concept description

  • data object

    Additional concept data

  • entity_concept_links array[string(uuid)]

    List of entity concept link identifiers

Responses

  • 201 application/json

    Concept successfully created

    Hide response attributes Show response attributes object
    • id string(uuid)

      Concept unique identifier

    • name string

      Concept name

    • description string

      Concept description

    • project_id string(uuid)

      Project identifier

    • data object

      Additional concept data

    • created_by string(uuid)

      Creator person identifier

    • created_at string(date-time)

      Creation timestamp

    • updated_at string(date-time)

      Last update timestamp

POST /data/projects/{project_id}/concepts
curl \
 --request POST 'http://api.example.com/data/projects/a24a6ea4-ce75-4665-a070-57453082c25/concepts' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"name":"Character Design","description":"Main character concept art","data":{"mood":"heroic","style":"realistic"},"entity_concept_links":["b35b7fb5-df86-5776-b181-68564193d36","c46c8gc6-eg97-6887-c292-79675204e47"]}'
Request examples
{
  "name": "Character Design",
  "description": "Main character concept art",
  "data": {
    "mood": "heroic",
    "style": "realistic"
  },
  "entity_concept_links": [
    "b35b7fb5-df86-5776-b181-68564193d36",
    "c46c8gc6-eg97-6887-c292-79675204e47"
  ]
}
Response examples (201)
{
  "id": "a24a6ea4-ce75-4665-a070-57453082c25",
  "name": "Character Design",
  "description": "Main character concept art",
  "project_id": "b35b7fb5-df86-5776-b181-68564193d36",
  "data": {
    "mood": "heroic",
    "style": "realistic"
  },
  "created_by": "d57d9hd7-fh08-7998-d403-80786315f58",
  "created_at": "2023-01-01T12:00:00Z",
  "updated_at": "2023-01-01T12:00:00Z"
}