Relevance AI

Relevance AI Agents API

The Agents API from Relevance AI — 7 operation(s) for agents.

GitHub OpenAPI

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

DELETE /agents/{agent_id}/conversations Delete several conversations for an agent · DeleteAgentConversations #
Ask an LLM
“Can I bulk-delete a batch of conversations from one agent?”
“How do I clear out multiple old agent conversations at once?”
Tell an agent destructive · confirm first
Delete conversations {conversation_ids} from agent {agent_id}.
Bulk-remove the listed conversations {conversation_ids} for agent {agent_id}.
DELETE /agents/{agent_id}/conversations/{conversation_id} Delete a single agent conversation · DeleteAgentConversation #
Ask an LLM
“How do I delete one specific conversation with an agent?”
“Can I remove just a single chat thread from an agent's history?”
Tell an agent destructive · confirm first
Delete conversation {conversation_id} of agent {agent_id}.
Remove the single chat {conversation_id} from agent {agent_id}'s history.
POST /agents/{agent_id}/tags/upsert Apply a tag to an agent · UpsertUserAgentTag #
Ask an LLM
“Can I label an agent with one of my project tags?”
“How do I attach a tag to a specific agent?”
Tell an agent
Tag agent {agent_id} with {tag_id}.
Attach tag {tag_id} to agent {agent_id}.
POST /agents/{agent_id}/tags/delete Remove a tag from an agent · DeleteUserAgentTag #
Ask an LLM
“How do I take a tag off an agent without deleting the tag itself?”
“Can I untag a single agent?”
Tell an agent destructive · confirm first
Remove tag {tag_id} from agent {agent_id}.
Untag agent {agent_id} by detaching {tag_id}.
GET /user_tags/list List tags in the current project · ListUserTags #
Ask an LLM
“What tags exist in my project for organizing agents?”
“Which colours and names have we given our project tags?”
Tell an agent
List all tags in this project.
Show me the project's tag names and colours.
POST /user_tags/upsert Create or update a project tag · UpsertUserTag #
Ask an LLM
“Can I create a new coloured tag for grouping agents?”
“How do I rename or recolour an existing project tag?”
Tell an agent
Create a project tag named {name} with colour {colour}.
Rename tag {tag_id} to {name} and set its colour to {colour}.
POST /user_tags/delete Delete a tag from the project · DeleteUserTag #
Ask an LLM
“How do I delete a tag from my project entirely?”
“What happens to a project tag once I delete it?”
Tell an agent destructive · confirm first
Delete project tag {tag_id}.
Remove the tag {tag_id} from this project altogether.

Documentation

📖
Documentation
https://relevanceai.com/docs
📖
APIReference
https://api-f1db6c.stack.tryrelevance.com/latest/documentation
📖
Authentication
https://artifacts.apis.io/relevance-ai/authentication/relevance-ai-authentication.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/relevance-ai/openapi/relevance-ai-agents-api-openapi.yml

Other Resources

🔗
ErrorCatalog
https://artifacts.apis.io/relevance-ai/errors/relevance-ai-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/relevance-ai/data-model/relevance-ai-data-model.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/relevance-ai:relevance-ai-agents-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

relevance-ai-agents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: Relevance AI Endpoints
  title: Relevance AI Endpoints Agents API
  version: latest
  contact:
    email: dev@tryrelevance.com
servers:
- url: /latest
security:
- AuthorizationHeader:
  - Authorization
tags:
- name: Agents
paths:
  /agents/{agent_id}/conversations:
    delete:
      summary: DeleteAgentConversations
      tags:
      - Agents
      description: 'Delete conversations for a specific agent


        ### Required permissions

        > []'
      operationId: DeleteAgentConversations
      parameters:
      - name: agent_id
        in: path
        description: ID of agent
        required: true
        schema:
          type: string
          maxLength: 240
          pattern: ^[a-zd._-]+$
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteAgentConversationsInput'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteAgentConversationsOutput'
  /agents/{agent_id}/conversations/{conversation_id}:
    delete:
      summary: DeleteAgentConversation
      tags:
      - Agents
      description: 'Delete a specific conversation for a specific agent


        ### Required permissions

        > []'
      operationId: DeleteAgentConversation
      parameters:
      - name: agent_id
        in: path
        description: ID of agent
        required: true
        schema:
          type: string
          maxLength: 240
          pattern: ^[a-zd._-]+$
      - name: conversation_id
        in: path
        description: ID of conversation
        required: true
        schema:
          type: string
          maxLength: 240
          pattern: ^[a-zd._-]+$
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteAgentConversationInput'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteAgentConversationOutput'
  /agents/{agent_id}/tags/upsert:
    post:
      summary: UpsertUserAgentTag
      tags:
      - Agents
      description: 'Upserts a tag to an agent


        ### Required permissions

        > [

        {

        "actions": [

        "role:editor"

        ]

        }

        ]'
      operationId: UpsertUserAgentTag
      parameters:
      - name: agent_id
        in: path
        description: ID of agent
        required: true
        schema:
          type: string
          maxLength: 240
          pattern: ^[a-zd._-]+$
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpsertUserAgentTagInput'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpsertUserAgentTagOutput'
  /agents/{agent_id}/tags/delete:
    post:
      summary: DeleteUserAgentTag
      tags:
      - Agents
      description: 'Deletes a tag from an agent


        ### Required permissions

        > [

        {

        "actions": [

        "role:editor"

        ]

        }

        ]'
      operationId: DeleteUserAgentTag
      parameters:
      - name: agent_id
        in: path
        description: ID of agent
        required: true
        schema:
          type: string
          maxLength: 240
          pattern: ^[a-zd._-]+$
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteUserAgentTagInput'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteUserAgentTagOutput'
  /user_tags/list:
    get:
      summary: ListUserTags
      tags:
      - Agents
      description: 'List all tags for the current project


        ### Required permissions

        > [

        {

        "actions": [

        "role:reader"

        ]

        }

        ]'
      operationId: ListUserTags
      parameters: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUserTagsOutput'
  /user_tags/upsert:
    post:
      summary: UpsertUserTag
      tags:
      - Agents
      description: 'Create or update a tag in the current project


        ### Required permissions

        > [

        {

        "actions": [

        "role:editor"

        ]

        }

        ]'
      operationId: UpsertUserTag
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpsertUserTagInput'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpsertUserTagOutput'
  /user_tags/delete:
    post:
      summary: DeleteUserTag
      tags:
      - Agents
      description: 'Delete a tag from the current project


        ### Required permissions

        > [

        {

        "actions": [

        "role:editor"

        ]

        }

        ]'
      operationId: DeleteUserTag
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteUserTagInput'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteUserTagOutput'
components:
  schemas:
    DeleteAgentConversationOutput:
      type: object
      properties: {}
      additionalProperties: false
    DeleteAgentConversationsOutput:
      type: object
      properties: {}
      additionalProperties: false
    DeleteAgentConversationsInput:
      type: object
      properties:
        conversation_ids:
          type: array
          items:
            type: string
          minItems: 1
          maxItems: 500
      required:
      - conversation_ids
      additionalProperties: false
    DeleteAgentConversationInput:
      type: object
      additionalProperties: false
    DeleteUserTagOutput:
      type: object
      properties: {}
      additionalProperties: false
    DeleteUserAgentTagInput:
      type: object
      properties:
        tag_id:
          type: string
      required:
      - tag_id
      additionalProperties: false
    UpsertUserAgentTagInput:
      type: object
      properties:
        tag_id:
          type: string
      required:
      - tag_id
      additionalProperties: false
    UpsertUserTagOutput:
      type: object
      properties:
        tag_id:
          type: string
      required:
      - tag_id
      additionalProperties: false
    UpsertUserTagInput:
      type: object
      properties:
        tag_id:
          type: string
          description: If provided, updates an existing tag. If omitted, creates a new tag.
        name:
          type: string
        colour:
          type: string
          enum:
          - gray
          - red
          - orange
          - yellow
          - green
          - blue
          - indigo
          - purple
          - violet
      required:
      - name
      - colour
      additionalProperties: false
    UpsertUserAgentTagOutput:
      type: object
      properties: {}
      additionalProperties: false
    DeleteUserTagInput:
      type: object
      properties:
        tag_id:
          type: string
      required:
      - tag_id
      additionalProperties: false
    DeleteUserAgentTagOutput:
      type: object
      properties: {}
      additionalProperties: false
    ListUserTagsOutput:
      type: object
      properties:
        results:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              colour:
                type: string
                enum:
                - gray
                - red
                - orange
                - yellow
                - green
                - blue
                - indigo
                - purple
                - violet
            required:
            - id
            - name
            - colour
            additionalProperties: false
      required:
      - results
      additionalProperties: false
  securitySchemes:
    AuthorizationHeader:
      type: apiKey
      in: header
      name: Authorization
      description: 'Authorization credentials. Header authorization should be in the form of: project:api_key'
x-provenance:
  method: harvested
  publisher: Relevance AI
  source: https://api-f1db6c.stack.tryrelevance.com/latest/openapi_schema.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)