Argilla responses API
The responses API from Argilla — 2 operation(s) for responses.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/argilla-responses-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Argilla v1 Authentication Responses API
description: Argilla Server API v1
version: 2.8.0
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0
contact:
email: contact@argilla.io
url: https://argilla.io
servers:
- url: https://argilla.io/api/v1
description: Argilla REST API v1
tags:
- name: responses
paths:
/me/responses/bulk:
post:
tags:
- responses
summary: Create Current User Responses Bulk
operationId: create_current_user_responses_bulk_me_responses_bulk_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsesBulkCreate'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsesBulk'
'400':
description: Bad Request
content:
application/json:
example:
detail:
code: argilla.api.errors::MissingDatasetRecordsError
params:
extra: error parameters
'404':
description: Not Found
content:
application/json:
example:
detail:
code: argilla.api.errors::EntityNotFoundError
params:
extra: error parameters
'403':
description: Forbidden
content:
application/json:
example:
detail:
code: argilla.api.errors::ForbiddenOperationError
params:
extra: error parameters
'409':
description: Conflict
content:
application/json:
example:
detail:
code: argilla.api.errors::EntityAlreadyExistsError
params:
extra: error parameters
'422':
description: Unprocessable Content
content:
application/json:
example:
detail:
code: argilla.api.errors::ValidationError
params:
extra: error parameters
'500':
description: Internal Server Error
content:
application/json:
example:
detail:
code: builtins.TypeError
security:
- APIKeyHeader: []
- HTTPBearer: []
/responses/{response_id}:
put:
tags:
- responses
summary: Update Response
operationId: update_response_responses__response_id__put
security:
- APIKeyHeader: []
- HTTPBearer: []
parameters:
- name: response_id
in: path
required: true
schema:
type: string
format: uuid
title: Response Id
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/SubmittedResponseUpdate'
- $ref: '#/components/schemas/DiscardedResponseUpdate'
- $ref: '#/components/schemas/DraftResponseUpdate'
discriminator:
propertyName: status
mapping:
submitted: '#/components/schemas/SubmittedResponseUpdate'
discarded: '#/components/schemas/DiscardedResponseUpdate'
draft: '#/components/schemas/DraftResponseUpdate'
title: Response Update
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'400':
content:
application/json:
example:
detail:
code: argilla.api.errors::MissingDatasetRecordsError
params:
extra: error parameters
description: Bad Request
'404':
content:
application/json:
example:
detail:
code: argilla.api.errors::EntityNotFoundError
params:
extra: error parameters
description: Not Found
'403':
content:
application/json:
example:
detail:
code: argilla.api.errors::ForbiddenOperationError
params:
extra: error parameters
description: Forbidden
'409':
content:
application/json:
example:
detail:
code: argilla.api.errors::EntityAlreadyExistsError
params:
extra: error parameters
description: Conflict
'422':
content:
application/json:
example:
detail:
code: argilla.api.errors::ValidationError
params:
extra: error parameters
description: Unprocessable Content
'500':
content:
application/json:
example:
detail:
code: builtins.TypeError
description: Internal Server Error
delete:
tags:
- responses
summary: Delete Response
operationId: delete_response_responses__response_id__delete
security:
- APIKeyHeader: []
- HTTPBearer: []
parameters:
- name: response_id
in: path
required: true
schema:
type: string
format: uuid
title: Response Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'400':
content:
application/json:
example:
detail:
code: argilla.api.errors::MissingDatasetRecordsError
params:
extra: error parameters
description: Bad Request
'404':
content:
application/json:
example:
detail:
code: argilla.api.errors::EntityNotFoundError
params:
extra: error parameters
description: Not Found
'403':
content:
application/json:
example:
detail:
code: argilla.api.errors::ForbiddenOperationError
params:
extra: error parameters
description: Forbidden
'409':
content:
application/json:
example:
detail:
code: argilla.api.errors::EntityAlreadyExistsError
params:
extra: error parameters
description: Conflict
'422':
content:
application/json:
example:
detail:
code: argilla.api.errors::ValidationError
params:
extra: error parameters
description: Unprocessable Content
'500':
content:
application/json:
example:
detail:
code: builtins.TypeError
description: Internal Server Error
components:
schemas:
ResponseBulk:
properties:
item:
$ref: '#/components/schemas/Response'
error:
$ref: '#/components/schemas/ResponseBulkError'
type: object
title: ResponseBulk
ResponseStatus:
type: string
enum:
- draft
- submitted
- discarded
title: ResponseStatus
ResponsesBulk:
properties:
items:
items:
$ref: '#/components/schemas/ResponseBulk'
type: array
title: Items
type: object
required:
- items
title: ResponsesBulk
DraftResponseUpsert:
properties:
values:
title: Values
additionalProperties:
$ref: '#/components/schemas/ResponseValueUpdate'
type:
- object
- 'null'
status:
type: string
enum:
- draft
const: draft
title: Status
record_id:
type: string
format: uuid
title: Record Id
type: object
required:
- status
- record_id
title: DraftResponseUpsert
ResponseBulkError:
properties:
detail:
type: string
title: Detail
type: object
required:
- detail
title: ResponseBulkError
SpanQuestionResponseValueItem:
properties:
label:
type: string
title: Label
start:
type: integer
minimum: 0.0
title: Start
end:
type: integer
minimum: 1.0
title: End
type: object
required:
- label
- start
- end
title: SpanQuestionResponseValueItem
DiscardedResponseUpdate:
properties:
values:
title: Values
additionalProperties:
$ref: '#/components/schemas/ResponseValueUpdate'
type:
- object
- 'null'
status:
type: string
enum:
- discarded
const: discarded
title: Status
type: object
required:
- status
title: DiscardedResponseUpdate
DiscardedResponseUpsert:
properties:
values:
title: Values
additionalProperties:
$ref: '#/components/schemas/ResponseValueUpdate'
type:
- object
- 'null'
status:
type: string
enum:
- discarded
const: discarded
title: Status
record_id:
type: string
format: uuid
title: Record Id
type: object
required:
- status
- record_id
title: DiscardedResponseUpsert
SubmittedResponseUpdate:
properties:
values:
additionalProperties:
$ref: '#/components/schemas/ResponseValueUpdate'
type: object
title: Values
status:
type: string
enum:
- submitted
const: submitted
title: Status
type: object
required:
- values
- status
title: SubmittedResponseUpdate
Response:
properties:
id:
type: string
format: uuid
title: Id
values:
title: Values
additionalProperties:
$ref: '#/components/schemas/ResponseValue'
type:
- object
- 'null'
status:
$ref: '#/components/schemas/ResponseStatus'
record_id:
type: string
format: uuid
title: Record Id
user_id:
type: string
format: uuid
title: User Id
inserted_at:
type: string
format: date-time
title: Inserted At
updated_at:
type: string
format: date-time
title: Updated At
type: object
required:
- id
- status
- record_id
- user_id
- inserted_at
- updated_at
title: Response
ResponseValue:
properties:
value:
title: Value
type: object
required:
- value
title: ResponseValue
ResponseValueUpdate:
properties:
value:
anyOf:
- items:
$ref: '#/components/schemas/SpanQuestionResponseValueItem'
type: array
maxItems: 10000
- items:
$ref: '#/components/schemas/RankingQuestionResponseValueItem'
type: array
- items:
type: string
type: array
- type: integer
- type: string
title: Value
type: object
required:
- value
title: ResponseValueUpdate
DraftResponseUpdate:
properties:
values:
title: Values
additionalProperties:
$ref: '#/components/schemas/ResponseValueUpdate'
type:
- object
- 'null'
status:
type: string
enum:
- draft
const: draft
title: Status
type: object
required:
- status
title: DraftResponseUpdate
ResponsesBulkCreate:
properties:
items:
items:
oneOf:
- $ref: '#/components/schemas/SubmittedResponseUpsert'
- $ref: '#/components/schemas/DiscardedResponseUpsert'
- $ref: '#/components/schemas/DraftResponseUpsert'
discriminator:
propertyName: status
mapping:
discarded: '#/components/schemas/DiscardedResponseUpsert'
draft: '#/components/schemas/DraftResponseUpsert'
submitted: '#/components/schemas/SubmittedResponseUpsert'
type: array
maxItems: 100
minItems: 1
title: Items
type: object
required:
- items
title: ResponsesBulkCreate
SubmittedResponseUpsert:
properties:
values:
additionalProperties:
$ref: '#/components/schemas/ResponseValueUpdate'
type: object
title: Values
status:
type: string
enum:
- submitted
const: submitted
title: Status
record_id:
type: string
format: uuid
title: Record Id
type: object
required:
- values
- status
- record_id
title: SubmittedResponseUpsert
RankingQuestionResponseValueItem:
properties:
value:
type: string
title: Value
rank:
title: Rank
type:
- integer
- 'null'
type: object
required:
- value
title: RankingQuestionResponseValueItem
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-Argilla-Api-Key
HTTPBearer:
type: http
scheme: bearer