Skip to main content
POST
/
v1
/
tasks
Create a task
curl --request POST \
  --url https://api.infinitecreator.com/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "assets": [
    {
      "url": "<string>",
      "type": "image",
      "model": "basic-1"
    }
  ],
  "agents": [
    {
      "id": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "picture": "<string>",
      "designation": "<string>",
      "phones": [
        {
          "number": "<string>",
          "type": "office",
          "region": "US"
        }
      ],
      "emails": [
        {
          "address": "[email protected]"
        }
      ],
      "licenses": [
        {
          "number": "<string>",
          "state": "<string>"
        }
      ],
      "video_options": {
        "ratio": "1920:1080",
        "components": {
          "intro": {
            "enabled": false,
            "background_color": "<string>",
            "primary_font": "Euclid Circular A",
            "secondary_font": "Euclid Circular A",
            "logo": "<string>",
            "font_color": "<string>"
          },
          "specs": {
            "enabled": false,
            "background_color": "<string>",
            "primary_font": "Euclid Circular A",
            "secondary_font": "Euclid Circular A",
            "font_color": "<string>"
          },
          "business_card": {
            "enabled": false,
            "background_color": "<string>",
            "primary_font": "Euclid Circular A",
            "secondary_font": "Euclid Circular A",
            "font_color": "<string>",
            "picture_shape": "square",
            "logo": "<string>"
          },
          "outro": {
            "enabled": false,
            "url": "<string>"
          },
          "overlay": {
            "enabled": false,
            "primary_font": "Euclid Circular A",
            "logo": "<string>"
          },
          "office": {
            "enabled": false,
            "logo": "<string>"
          }
        },
        "create_preview": false,
        "metadata": {}
      },
      "offices": [
        {
          "name": "<string>",
          "address": {
            "street": "<string>",
            "state": "<string>",
            "city": "<string>",
            "postal_code": "<string>"
          },
          "phone_number": {
            "number": "<string>",
            "type": "office",
            "region": "US"
          }
        }
      ]
    }
  ],
  "address": {
    "street": "<string>",
    "state": "<string>",
    "city": "<string>",
    "postal_code": "<string>"
  },
  "bedrooms": 1,
  "bathrooms": 1,
  "half_bathrooms": 1,
  "interior_square_footage": 2
}
'
{
  "id": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
infinitecreator-beta
string[]

Beta headers allow you to access experimental features and new model capabilities before they become part of the standard API.

Body

application/json
​
id
string
required

Unique identifier for the listing.

Example:

"L12345678"

​
assets
Asset · object[]
required

Listing assets.

Required array length: 5 - 100 elements
​
agents
Agent · object[]
required

Agents associated with the listing. We will make 1 video per agent.

Required array length: 1 - 20 elements
​
address
Address · object

Listing address.

​
bedrooms
integer

Number of bedrooms

Required range: x >= 0
Example:

3

​
bathrooms
integer

Number of bathrooms

Required range: x >= 0
Example:

2

​
half_bathrooms
integer

Number of half bathrooms

Required range: x >= 0
Example:

1

​
interior_square_footage
number

Interior square footage

Required range: x >= 1
Example:

1231.5

Response

Successful Response

​
id
string
required

Unique identifier for the task.

Example:

"01K364FEGEDX32AK5RK447H2KP"

Last modified on January 7, 2026