generated: '2026-07-15' method: generated source: openapi/argilla-rest-api-openapi.yml description: Recommended x-agentic-access execution contracts, classified heuristically from the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind audience per deployment. See research/curity/agentic-governance/. summary: operations: 73 by_action_class: connected: 29 acting: 44 by_consequence: read: 29 write: 44 human_in_the_loop_required: 0 operations: - path: /version method: get operationId: get_version_version_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /status method: get operationId: get_status_status_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /token method: post operationId: create_token_token_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /me/datasets method: get operationId: list_current_user_datasets_me_datasets_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets/{dataset_id}/fields method: get operationId: list_dataset_fields_datasets__dataset_id__fields_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets/{dataset_id}/fields method: post operationId: create_dataset_field_datasets__dataset_id__fields_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id}/vectors-settings method: get operationId: list_dataset_vector_settings_datasets__dataset_id__vectors_settings_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets/{dataset_id}/vectors-settings method: post operationId: create_dataset_vector_settings_datasets__dataset_id__vectors_settings_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /me/datasets/{dataset_id}/metadata-properties method: get operationId: list_current_user_dataset_metadata_properties_me_datasets__dataset_id__metadata_properties_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets/{dataset_id} method: get operationId: get_dataset_datasets__dataset_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets/{dataset_id} method: delete operationId: delete_dataset_datasets__dataset_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id} method: patch operationId: update_dataset_datasets__dataset_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /me/datasets/{dataset_id}/metrics method: get operationId: get_current_user_dataset_metrics_me_datasets__dataset_id__metrics_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets/{dataset_id}/progress method: get operationId: get_dataset_progress_datasets__dataset_id__progress_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets/{dataset_id}/users/progress method: get operationId: get_dataset_users_progress_datasets__dataset_id__users_progress_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets method: post operationId: create_dataset_datasets_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id}/metadata-properties method: post operationId: create_dataset_metadata_property_datasets__dataset_id__metadata_properties_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id}/publish method: put operationId: publish_dataset_datasets__dataset_id__publish_put x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id}/import method: post operationId: import_dataset_from_hub_datasets__dataset_id__import_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id}/export method: post operationId: export_dataset_to_hub_datasets__dataset_id__export_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id}/questions method: get operationId: list_dataset_questions_datasets__dataset_id__questions_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets/{dataset_id}/questions method: post operationId: create_dataset_question_datasets__dataset_id__questions_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id}/records method: get operationId: list_dataset_records_datasets__dataset_id__records_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets/{dataset_id}/records method: delete operationId: delete_dataset_records_datasets__dataset_id__records_delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /me/datasets/{dataset_id}/records/search method: post operationId: search_current_user_dataset_records_me_datasets__dataset_id__records_search_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id}/records/search method: post operationId: search_dataset_records_datasets__dataset_id__records_search_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id}/records/search/suggestions/options method: get operationId: list_dataset_records_search_suggestions_options_datasets__dataset_id__records_search_suggestions_options_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /datasets/{dataset_id}/records/bulk method: post operationId: create_dataset_records_bulk_datasets__dataset_id__records_bulk_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /datasets/{dataset_id}/records/bulk method: put operationId: upsert_dataset_records_bulk_datasets__dataset_id__records_bulk_put x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /fields/{field_id} method: patch operationId: update_field_fields__field_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /fields/{field_id} method: delete operationId: delete_field_fields__field_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /questions/{question_id} method: patch operationId: update_question_questions__question_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /questions/{question_id} method: delete operationId: delete_question_questions__question_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /metadata-properties/{metadata_property_id}/metrics method: get operationId: get_metadata_property_metrics_metadata_properties__metadata_property_id__metrics_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /metadata-properties/{metadata_property_id} method: patch operationId: update_metadata_property_metadata_properties__metadata_property_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /metadata-properties/{metadata_property_id} method: delete operationId: delete_metadata_property_metadata_properties__metadata_property_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /records/{record_id} method: get operationId: get_record_records__record_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /records/{record_id} method: patch operationId: update_record_records__record_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /records/{record_id} method: delete operationId: delete_record_records__record_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /records/{record_id}/responses method: post operationId: create_record_response_records__record_id__responses_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /records/{record_id}/suggestions method: get operationId: get_record_suggestions_records__record_id__suggestions_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /records/{record_id}/suggestions method: put operationId: upsert_suggestion_records__record_id__suggestions_put x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /records/{record_id}/suggestions method: delete operationId: delete_record_suggestions_records__record_id__suggestions_delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /me/responses/bulk method: post operationId: create_current_user_responses_bulk_me_responses_bulk_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /responses/{response_id} method: put operationId: update_response_responses__response_id__put x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /responses/{response_id} method: delete operationId: delete_response_responses__response_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /suggestions/{suggestion_id} method: delete operationId: delete_suggestion_suggestions__suggestion_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /me method: get operationId: get_current_user_me_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{user_id} method: get operationId: get_user_users__user_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{user_id} method: delete operationId: delete_user_users__user_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /users/{user_id} method: patch operationId: update_user_users__user_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /users method: get operationId: list_users_users_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users method: post operationId: create_user_users_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /users/{user_id}/workspaces method: get operationId: list_user_workspaces_users__user_id__workspaces_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /vectors-settings/{vector_settings_id} method: patch operationId: update_vector_settings_vectors_settings__vector_settings_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /vectors-settings/{vector_settings_id} method: delete operationId: delete_vector_settings_vectors_settings__vector_settings_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /workspaces/{workspace_id} method: get operationId: get_workspace_workspaces__workspace_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /workspaces/{workspace_id} method: delete operationId: delete_workspace_workspaces__workspace_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /workspaces method: post operationId: create_workspace_workspaces_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /me/workspaces method: get operationId: list_workspaces_me_me_workspaces_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /workspaces/{workspace_id}/users method: get operationId: list_workspace_users_workspaces__workspace_id__users_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /workspaces/{workspace_id}/users method: post operationId: create_workspace_user_workspaces__workspace_id__users_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /workspaces/{workspace_id}/users/{user_id} method: delete operationId: delete_workspace_user_workspaces__workspace_id__users__user_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /webhooks method: get operationId: list_webhooks_webhooks_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /webhooks method: post operationId: create_webhook_webhooks_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /webhooks/{webhook_id} method: patch operationId: update_webhook_webhooks__webhook_id__patch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /webhooks/{webhook_id} method: delete operationId: delete_webhook_webhooks__webhook_id__delete x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /webhooks/{webhook_id}/ping method: post operationId: ping_webhook_webhooks__webhook_id__ping_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /jobs/{job_id} method: get operationId: get_job_jobs__job_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /oauth2/providers method: get operationId: list_providers_oauth2_providers_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /oauth2/providers/{provider}/authentication method: get operationId: get_authentication_oauth2_providers__provider__authentication_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /oauth2/providers/{provider}/access-token method: get operationId: get_access_token_oauth2_providers__provider__access_token_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /settings method: get operationId: get_settings_settings_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none