VEvercel
Chats

Create Chat (Async)

Changed on

Creates a new chat with a user message and processes it in the background. Returns immediately with the chat ID and message ID. Poll for the assistant message by ID until finishReason is non-null.

post/chats/async

Request

  • Base URL
    https://api.v0.dev/v2
  • URL
    https://api.v0.dev/v2/chats/async
  • Auth
    HTTP bearer

Request body

messagestring required

The prompt or instruction to send to the model.

systemPromptstring

System-level context for the chat, such as frameworks or development environment details.

mcpServerIdsstring[]

MCP server IDs to enable. When omitted, uses default enabled servers.

privacy'public' | 'private' | 'team' | 'team-edit' | 'unlisted'

Visibility setting for the new chat.

titlestring

Title for the new chat.

metadataobject

Arbitrary key-value data to attach to the chat.

Response

Response for status 202

chatIdstring required

Unique chat identifier.

messageIdstring required

ID of the assistant message that will receive the response. Poll this message by ID and check its finishReason field to detect completion.

Changes

  • 467d24b4c224Revision changes
    • breaking

      removed the enum value v0-max of the request property / (media type: application/json)

    • breaking

      removed the enum value v0-max of the request property / (media type: application/x-www-form-urlencoded)

    • breaking

      removed the enum value v0-max of the request property / (media type: multipart/form-data)

    • breaking

      removed the enum value v0-max-fast of the request property / (media type: application/json)

    • breaking

      removed the enum value v0-max-fast of the request property / (media type: application/x-www-form-urlencoded)

    • breaking

      removed the enum value v0-max-fast of the request property / (media type: multipart/form-data)

    • breaking

      removed the enum value v0-mini of the request property / (media type: application/json)

    • breaking

      removed the enum value v0-mini of the request property / (media type: application/x-www-form-urlencoded)

    • breaking

      removed the enum value v0-mini of the request property / (media type: multipart/form-data)

    • breaking

      removed the enum value v0-pro of the request property / (media type: application/json)

    • breaking

      removed the enum value v0-pro of the request property / (media type: application/x-www-form-urlencoded)

    • breaking

      removed the enum value v0-pro of the request property / (media type: multipart/form-data)

    • breaking

      the / request property type changed from string to no type (media type: application/json)

    • info

      added subschema #1 subschema #2 to the / request property anyOf list (media type: application/json)

    • info

      added subschema #1 subschema #2 to the / request property anyOf list (media type: application/x-www-form-urlencoded)

    • info

      added subschema #1 subschema #2 to the / request property anyOf list (media type: multipart/form-data)

    • info

      the / request property type was generalized from string to no type (media type: application/x-www-form-urlencoded)

    • info

      the / request property type was generalized from string to no type (media type: multipart/form-data)

  • 1d09b399c67fRevision changes
    • info

      added the new optional request property / (media type: application/json)

    • info

      added the new optional request property / (media type: application/x-www-form-urlencoded)

    • info

      added the new optional request property / (media type: multipart/form-data)

    • info

      added the new optional request property / (media type: application/json)

    • info

      added the new optional request property / (media type: application/x-www-form-urlencoded)

    • info

      added the new optional request property / (media type: multipart/form-data)