Get the profile library

POST 
/api/v1/agent-profiles/library

Returns the project's profile-selection library for building a picker. Its selection metadata omits runtime configuration; use get to inspect or edit a full profile. This discovery projection neither proves that an autonomous router is active nor guarantees a measured cost or latency improvement.

For a native conversation, pass the chosen profile ID through activeProfileId on thread creation or setActiveProfileId when sending a message; Travila loads its configuration. The returned defaultProfileId is not applied automatically when activeProfileId is empty. Your client must explicitly select its intended profile.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Build a reusable assistant profile

Request

Responses

200

Selection metadata for the project

Read the enabled profile library in the authenticated project; no additional body fields are needed.

Section ID: DOC-MA-profiles-prompts-api-getAgentProfileLibrary#example-agent-profiles-getAgentProfileLibrary-request

Request example

{}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-MA-profiles-prompts-api-getAgentProfileLibrary#example-agent-profiles-getAgentProfileLibrary-response

Response example

{
  "library": {
    "profiles": [
      {
        "profileId": "example_123",
        "name": "example",
        "description": "example",
        "whenToUse": "example",
        "keywords": [
          "example_123"
        ],
        "enabled": true
      }
    ],
    "defaultProfileId": "example_123"
  }
}

Illustrative response for Variant: let the user choose an assistant. Replace example resource identifiers with your own authorized values.

Section ID: DOC-MA-profiles-prompts-api-getAgentProfileLibrary#example-cookbook-managed-agents-profiles-prompts-index-json-04-response

Response example

{
  "library": {
    "profiles": [
      {
        "profileId": "nutrition_coach",
        "name": "Nutrition Coach",
        "description": "Food, meals and macros.",
        "whenToUse": "Use when the user asks about food, meals, or macros.",
        "keywords": [
          "nutrition",
          "food",
          "macros"
        ],
        "enabled": true
      }
    ],
    "defaultProfileId": "generalist"
  }
}

Document ID: DOC-MA-profiles-prompts-api-getAgentProfileLibrary. Section identities and revisions.

Section	Stable reference
Get the profile library	DOC-MA-profiles-prompts-api-getAgentProfileLibrary#overview
Request	DOC-MA-profiles-prompts-api-getAgentProfileLibrary#request
Responses	DOC-MA-profiles-prompts-api-getAgentProfileLibrary#responses