Sign in
Agents Platform

List Proposals

List the proposals for an agent, newest first.

get/v1/convai/agents/{agent_id}/merge-proposals

Path parameters

agent_idstring required

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

Example:agent_3701k3ttaq12ewp8b7qv5rfyszkz

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

Query parameters

status'open' | 'merged' | 'closed'

Only return proposals with this status.

searchstring nullable

Case-insensitive substring match over title and description.

Case-insensitive substring match over title and description.

page_sizeinteger

How many results at most should be returned

How many results at most should be returned

cursorstring nullable

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

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

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

next_cursorstring nullable required
has_moreboolean required

Example response

{
  "results": [
    {
      "access_info": {
        "access_source": "creator",
        "creator_email": "john.doe@example.com",
        "creator_name": "John Doe",
        "is_creator": true,
        "role": "admin"
      }
    }
  ]
}

Changes

Changed in 1 of the 51 revisions of this API.1