List Proposals

GET

/v1/convai/agents/:agent_id/merge-proposals

GET

/v1/convai/agents/:agent_id/merge-proposals

curl -G https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/merge-proposals \
     -d cursor=cursor \
     -d page_size=1 \
     -d search=search \
     -d status=open

{
  "results": [
    {
      "id": "id",
      "agent_id": "agent_id",
      "source_branch_id": "source_branch_id",
      "target_branch_id": "target_branch_id",
      "source_tip_version_id_at_creation": "source_tip_version_id_at_creation",
      "title": "title",
      "created_at": 1,
      "updated_at": 1,
      "description": "description",
      "requested_reviewer_user_ids": [
        "requested_reviewer_user_ids"
      ],
      "reviews": [
        {
          "user_id": "user_id",
          "state": "approved",
          "submitted_at": 1
        }
      ],
      "comments": [
        {
          "id": "id",
          "user_id": "user_id",
          "body": "body",
          "created_at": 1
        }
      ],
      "outcome": {
        "status": "closed",
        "at": 1,
        "reason": "withdrawn",
        "by_user_id": null
      },
      "author_user_id": "author_user_id",
      "access_info": {
        "is_creator": true,
        "creator_name": "John Doe",
        "creator_email": "john.doe@example.com",
        "role": "admin",
        "access_source": "creator"
      }
    }
  ],
  "next_cursor": "next_cursor",
  "has_more": true
}

List the proposals for an agent, newest first.

Path parameters

agent_idstringRequired

The id of an agent. This is returned on agent creation.

Query parameters

statusenumOptional

Only return proposals with this status.

Allowed values:

searchstringOptional<=140 characters

Case-insensitive substring match over title and description.

page_sizeintegerOptional1-100Defaults to 100

How many results at most should be returned

cursorstringOptional

Used for fetching next page. Cursor is returned in the response.

Response

Successful Response

resultslist of objects

next_cursorstringOptional

has_morebooleanOptionalRead-only

Errors

422

Merge Proposals List Request Unprocessable Entity Error

Path parameters

Headers

Query parameters

Response

Errors