ROroarkhq
Agent

Build a Roark-hosted agent

Changed on

Creates a new Roark-hosted agent from a one-line job description. Roark authors the system prompt and hosts the config, so the agent is live and self-improvable from creation.

post/v1/agent/build

Request

  • Base URL
    https://api.roark.ai
  • URL
    https://api.roark.ai/v1/agent/build
  • Auth
    HTTP bearer

Request body

namestring required

Name of the agent

jobDescriptionstring required

One-line description of what the agent should do. Roark authors the system prompt from this.

voicestring nullable

Optional display name of the agent's voice. The authored prompt matches its delivery to it.

Response

The built agent

Changes

  • 08bd8a3ed869Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property /

    • info

      added the non-success response with the status

  • d82d66648ffdRevision changes
    • breaking

      request property / was restricted to a list of enum values

    • info

      added the new CARTESIA enum value to the request property /

    • info

      added the new ELEVENLABS enum value to the request property /

    • info

      added the new OPENAI enum value to the request property /

    • info

      added the new RIME enum value to the request property /

    • info

      the / request property's minLength was decreased from 1 to 0