Sign in
Prompts

Create a prompt

Create a new prompt with an initial version.

Payload Requirements

  • The prompt name must be unique within the given space.
  • At least one message is required.

<Note>This endpoint is in beta, read more here.</Note>

post/v2/prompts

Request body

space_idstring required

ID of the space to create the prompt in

namestring required

Name of the prompt (must be unique within the space)

descriptionstring

Description of the prompt. Optional. If omitted, the prompt has no description.

Response

A prompt object with a resolved version

idstring required

The prompt ID

namestring required

The prompt name

descriptionstring nullable

The prompt description

space_idstring required

The space ID the prompt belongs to

created_atstring date-time required

When the prompt was created

updated_atstring date-time required

When the prompt was last updated

created_by_user_idstring required

The user ID of the user who created the prompt

Changes

Changed in 3 of the 16 revisions of this API.551

  • 9263b98aaefb1See the full diff
    • ○

      added the optional property allOf[subschema #2]/version/invocation_params/allOf[InvocationParams]/service_tier to the response with the 201 status

      response-optional-property-added

  • 4d95080d8ffb11See the full diff
    • ▲

      added ToolConfigRequest to the version/invocation_params/tool_config request property allOf list

      request-property-all-of-added

    • ●

      removed ToolConfig from the version/invocation_params/tool_config request property allOf list

      request-property-all-of-removed

  • 1e87d8a4cf6944See the full diff
    • ▲

      added AnthropicHeadersRequest to the version/provider_params/anthropic_headers request property allOf list

      request-property-all-of-added

    • ▲

      added AzureParamsRequest to the version/provider_params/azure_params request property allOf list

      request-property-all-of-added

    • ▲

      added BedrockOptionsRequest to the version/provider_params/bedrock_options request property allOf list

      request-property-all-of-added

    • ▲

      added ResponseFormatRequest to the version/invocation_params/response_format request property allOf list

      request-property-all-of-added

    • ●

      removed AnthropicHeaders from the version/provider_params/anthropic_headers request property allOf list

      request-property-all-of-removed

    • ●

      removed AzureParams from the version/provider_params/azure_params request property allOf list

      request-property-all-of-removed

    • ●

      removed BedrockOptions from the version/provider_params/bedrock_options request property allOf list

      request-property-all-of-removed

    • ●

      removed ResponseFormat from the version/invocation_params/response_format request property allOf list

      request-property-all-of-removed

Of the 16 revisions, 1 has no diff computed.