KEkeywordsai
Prompts

Create a prompt

Changed on
post/api/prompts/

Request

  • Base URL
    https://api.respan.ai
  • URL
    https://api.respan.ai/api/prompts/
  • Auth
    • HTTP bearer
    • or HTTP bearer

Request body

namestring

Prompt name. Defaults to Untitled.

descriptionstring

Prompt description.

Example request

{
  "name": "customer_support",
  "description": "Support chatbot prompt"
}

Response

Prompt created successfully.

idstring

The unique prompt identifier.

namestring
descriptionstring nullable
prompt_slugstring nullable

Example response

{
  "id": "prompt_new123",
  "name": "Customer Support Assistant",
  "description": "Handles customer support queries with empathy",
  "prompt_slug": "customer-support-assistant",
  "tags": [],
  "current_version": null,
  "live_version": null,
  "created_at": "2026-01-21T12:00:00Z",
  "updated_at": "2026-01-21T12:00:00Z"
}

Changes

  • c30bcb383ee8Revision changes
    • breaking

      request body became required

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the response's property type changed from no type to object for status

    • info

      api operation id prompts_createPrompt removed and replaced with createPrompt

    • info

      the endpoint scheme security DashboardJwt was added to the API

    • info

      api tag Prompts added

    • info

      api tag prompts removed

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      removed subschema #2 from the response property oneOf list for the response status

    • info

      removed subschema #2 from the response property oneOf list for the response status

  • b830b79cfd52Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      the request property became optional

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status