Gen AI Builder v2023-09-19
Scroll down for example requests and responses.
Base URLs:
Authentication
- HTTP Authentication, scheme: Bearer HTTP Bearer authentication
Default
ListUsers
GET /users
Example responses
200 Response
{ "properties": { "users": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "email": { "type": "string" }, "name": { "type": "string" }, "organizations": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" }, "user_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "created_at", "email", "organizations", "updated_at", "user_id" ], "type": "object" }, "type": "array" } }, "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListUsers 200 response | ListUsersResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ApiKeys
DeleteApiKey
DELETE /api-keys/{api_key_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
api_key_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteApiKey 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetApiKey
GET /api-keys/{api_key_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
api_key_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "active": { "type": "boolean" }, "api_key_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "active", "api_key_id", "created_at", "created_by", "last_used", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetApiKey 200 response | GetApiKeyResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateApiKey
PATCH /api-keys/{api_key_id}
Body parameter
{ "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
api_key_id | path | string | true | none |
body | body | UpdateApiKeyRequestContent | false | none |
Example responses
200 Response
{ "properties": { "active": { "type": "boolean" }, "api_key_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "active", "api_key_id", "created_at", "created_by", "last_used", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateApiKey 200 response | UpdateApiKeyResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListOrganizationApiKeys
GET /organizations/{organization_id}/api-keys
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
organization_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "api_keys": { "items": { "properties": { "active": { "type": "boolean" }, "api_key_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "active", "api_key_id", "created_at", "created_by", "last_used", "name", "organization_id", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "api_keys", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListOrganizationApiKeys 200 response | ListOrganizationApiKeysResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateOrganizationApiKey
POST /organizations/{organization_id}/api-keys
Body parameter
{ "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
organization_id | path | string | true | none |
body | body | CreateOrganizationApiKeyRequestContent | true | none |
Example responses
201 Response
{ "properties": { "active": { "type": "boolean" }, "api_key_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "value": { "type": "string" } }, "required": [ "active", "api_key_id", "created_at", "created_by", "last_used", "name", "organization_id", "updated_at", "value" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateOrganizationApiKey 201 response | CreateOrganizationApiKeyResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListApiKeys
GET /users/{user_id}/api-keys
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
user_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "api_keys": { "items": { "properties": { "active": { "type": "boolean" }, "api_key_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "active", "api_key_id", "created_at", "created_by", "last_used", "name", "organization_id", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "api_keys", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListApiKeys 200 response | ListApiKeysResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateApiKey
POST /users/{user_id}/api-keys
Body parameter
{ "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
user_id | path | string | true | none |
body | body | CreateApiKeyRequestContent | true | none |
Example responses
201 Response
{ "properties": { "active": { "type": "boolean" }, "api_key_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "value": { "type": "string" } }, "required": [ "active", "api_key_id", "created_at", "created_by", "last_used", "name", "organization_id", "updated_at", "value" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateApiKey 201 response | CreateApiKeyResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
AssistantRuns
GetAssistantRun
GET /assistant-runs/{assistant_run_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
assistant_run_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "assistant_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "output": {}, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "stream": { "type": "boolean" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "assistant_id", "assistant_run_id", "completed_at", "created_at", "created_by", "knowledge_base_ids", "retriever_ids", "ruleset_ids", "status", "stream", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetAssistantRun 200 response | GetAssistantRunResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CancelAssistantRun
POST /assistant-runs/{assistant_run_id}/cancel
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
assistant_run_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "assistant_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "output": {}, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "stream": { "type": "boolean" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "assistant_id", "assistant_run_id", "completed_at", "created_at", "created_by", "knowledge_base_ids", "retriever_ids", "ruleset_ids", "status", "stream", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | CancelAssistantRun 200 response | CancelAssistantRunResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListAssistantRuns
GET /assistants/{assistant_id}/runs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
assistant_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
status | query | array[string] | false | Comma-separated list of run statuses to filter by. |
Enumerated Values
Parameter | Value |
---|---|
status | QUEUED |
status | STARTING |
status | RUNNING |
status | SUCCEEDED |
status | FAILED |
status | ERROR |
status | CANCELLED |
Example responses
200 Response
{ "properties": { "assistant_runs": { "items": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "assistant_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "output": {}, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "stream": { "type": "boolean" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "assistant_id", "assistant_run_id", "completed_at", "created_at", "created_by", "knowledge_base_ids", "retriever_ids", "ruleset_ids", "status", "stream", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "assistant_runs", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListAssistantRuns 200 response | ListAssistantRunsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateAssistantRun
POST /assistants/{assistant_id}/runs
Body parameter
{ "properties": { "additional_knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "additional_retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "additional_ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "additional_structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "additional_tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "args": { "items": { "type": "string" }, "type": "array" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "new_thread": { "description": "If true, create a new thread for this run to be returned in the response thread_id.", "type": "boolean" }, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "stream": { "type": "boolean" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "thread_id": { "description": "If provided, the run will be associated with the given thread. This takes precedence over new_thread.", "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
assistant_id | path | string | true | none |
body | body | CreateAssistantRunRequestContent | false | none |
Example responses
201 Response
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "assistant_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "output": {}, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "stream": { "type": "boolean" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "assistant_id", "assistant_run_id", "completed_at", "created_at", "created_by", "knowledge_base_ids", "retriever_ids", "ruleset_ids", "status", "stream", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateAssistantRun 201 response | CreateAssistantRunResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Events
ListAssistantEvents
GET /assistant-runs/{assistant_run_id}/events
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
assistant_run_id | path | string | true | none |
limit | query | string | false | none |
offset | query | string | false | none |
Example responses
200 Response
{ "properties": { "count": { "type": "number" }, "events": { "items": { "properties": { "assistant_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "event_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "origin": { "type": "string" }, "payload": {}, "timestamp": { "format": "double", "type": "number" }, "type": { "type": "string" } }, "required": [ "assistant_run_id", "created_at", "event_id", "origin", "payload", "timestamp", "type" ], "type": "object" }, "type": "array" }, "limit": { "type": "number" }, "next_offset": { "type": "number" }, "offset": { "type": "number" }, "total_count": { "type": "number" } }, "required": [ "count", "events", "limit", "next_offset", "offset", "total_count" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListAssistantEvents 200 response | ListAssistantEventsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetAssistantRunEventsSSE
GET /assistant-runs/{assistant_run_id}/events/stream
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
assistant_run_id | path | string | true | none |
Example responses
200 Response
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetAssistantRunEventsSSE 200 response | GetAssistantRunEventsSSEOutputPayload |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetEvent
GET /events/{event_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
event_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "event_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "origin": { "type": "string" }, "payload": {}, "structure_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "timestamp": { "format": "double", "type": "number" }, "type": { "type": "string" } }, "required": [ "created_at", "event_id", "origin", "payload", "structure_run_id", "timestamp", "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetEvent 200 response | GetEventResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListEvents
GET /structure-runs/{structure_run_id}/events
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_run_id | path | string | true | none |
limit | query | string | false | none |
offset | query | string | false | none |
Example responses
200 Response
{ "properties": { "count": { "type": "number" }, "events": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "event_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "origin": { "type": "string" }, "payload": {}, "structure_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "timestamp": { "format": "double", "type": "number" }, "type": { "type": "string" } }, "required": [ "created_at", "event_id", "origin", "payload", "structure_run_id", "timestamp", "type" ], "type": "object" }, "type": "array" }, "limit": { "type": "number" }, "next_offset": { "type": "number" }, "offset": { "type": "number" }, "total_count": { "type": "number" } }, "required": [ "count", "events", "limit", "next_offset", "offset", "total_count" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListEvents 200 response | ListEventsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateEvents
POST /structure-runs/{structure_run_id}/events
Body parameter
{ "properties": { "events": { "items": { "properties": { "payload": {}, "timestamp": { "format": "double", "type": "number" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "timestamp", "type" ], "type": "object" }, "type": "array" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_run_id | path | string | true | none |
body | body | CreateEventsRequestContent | false | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
202 | Accepted | CreateEvents 202 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetStructureRunEventsSSE
GET /structure-runs/{structure_run_id}/events/stream
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_run_id | path | string | true | none |
Example responses
200 Response
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetStructureRunEventsSSE 200 response | GetStructureRunEventsSSEOutputPayload |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Assistants
ListAssistants
GET /assistants
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "assistants": { "items": { "properties": { "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_id", "created_at", "created_by", "description", "knowledge_base_ids", "name", "organization_id", "retriever_ids", "ruleset_ids", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "assistants", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListAssistants 200 response | ListAssistantsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateAssistant
POST /assistants
Body parameter
{ "properties": { "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateAssistantRequestContent | true | none |
Example responses
201 Response
{ "properties": { "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_id", "created_at", "created_by", "description", "knowledge_base_ids", "name", "organization_id", "retriever_ids", "ruleset_ids", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateAssistant 201 response | CreateAssistantResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteAssistant
DELETE /assistants/{assistant_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
assistant_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteAssistant 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetAssistant
GET /assistants/{assistant_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
assistant_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_id", "created_at", "created_by", "description", "knowledge_base_ids", "name", "organization_id", "retriever_ids", "ruleset_ids", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetAssistant 200 response | GetAssistantResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateAssistant
PATCH /assistants/{assistant_id}
Body parameter
{ "properties": { "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
assistant_id | path | string | true | none |
body | body | UpdateAssistantRequestContent | false | none |
Example responses
200 Response
{ "properties": { "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_id", "created_at", "created_by", "description", "knowledge_base_ids", "name", "organization_id", "retriever_ids", "ruleset_ids", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateAssistant 200 response | UpdateAssistantResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Billing
CreateCheckoutSession
POST /billing/checkout-session
Body parameter
{ "properties": { "price_lookup_key": { "type": "string" } }, "required": [ "price_lookup_key" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateCheckoutSessionRequestContent | true | none |
Example responses
201 Response
{ "properties": { "redirect_url": { "type": "string" } }, "required": [ "redirect_url" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateCheckoutSession 201 response | CreateCheckoutSessionResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateBillingManagementUrl
POST /billing/management-url
Example responses
201 Response
{ "properties": { "billing_management_url": { "type": "string" } }, "required": [ "billing_management_url" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateBillingManagementUrl 201 response | CreateBillingManagementUrlResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Buckets
ListBuckets
GET /buckets
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "buckets": { "items": { "properties": { "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "bucket_id", "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "buckets", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListBuckets 200 response | ListBucketsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateBucket
POST /buckets
Body parameter
{ "properties": { "name": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateBucketRequestContent | true | none |
Example responses
201 Response
{ "properties": { "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "bucket_id", "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateBucket 201 response | CreateBucketResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteBucket
DELETE /buckets/{bucket_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
bucket_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteBucket 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetBucket
GET /buckets/{bucket_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
bucket_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "bucket_id", "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetBucket 200 response | GetBucketResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateBucket
PATCH /buckets/{bucket_id}
Body parameter
{ "properties": { "name": { "maxLength": 256, "minLength": 1, "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
bucket_id | path | string | true | none |
body | body | UpdateBucketRequestContent | false | none |
Example responses
200 Response
{ "properties": { "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "bucket_id", "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateBucket 200 response | UpdateBucketResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Assets
CreateAssetUrl
POST /buckets/{bucket_id}/asset-urls/{name}
Body parameter
{ "properties": { "operation": { "enum": [ "PUT", "GET" ], "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
name | path | string | true | none |
bucket_id | path | string | true | none |
body | body | CreateAssetUrlRequestContent | false | none |
Example responses
200 Response
{ "properties": { "headers": { "additionalProperties": {}, "type": "object" }, "url": { "type": "string" } }, "required": [ "headers", "url" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | CreateAssetUrl 200 response | CreateAssetUrlResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListAssets
GET /buckets/{bucket_id}/assets
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
bucket_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
prefix | query | string | false | none |
postfix | query | string | false | none |
Example responses
200 Response
{ "properties": { "assets": { "items": { "properties": { "bucket_id": { "type": "string" }, "contents": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "size": { "type": "number" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "postfix": { "type": "string" }, "prefix": { "type": "string" } }, "required": [ "assets", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListAssets 200 response | ListAssetsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateAsset
PUT /buckets/{bucket_id}/assets
Body parameter
{ "properties": { "name": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
bucket_id | path | string | true | none |
body | body | CreateAssetRequestContent | true | none |
Example responses
201 Response
{ "properties": { "bucket_id": { "type": "string" }, "contents": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "size": { "type": "number" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateAsset 201 response | CreateAssetResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteAsset
DELETE /buckets/{bucket_id}/assets/{name}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
name | path | string | true | none |
bucket_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteAsset 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetAsset
GET /buckets/{bucket_id}/assets/{name}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
name | path | string | true | none |
bucket_id | path | string | true | none |
include_contents | query | boolean | false | true/false to include contents for the asset. |
Example responses
200 Response
{ "properties": { "bucket_id": { "type": "string" }, "contents": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "size": { "type": "number" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetAsset 200 response | GetAssetResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Chat Messages
CreateChatMessage
POST /chat/messages
Body parameter
{ "properties": { "driver_configuration": { "properties": { "extra_params": {}, "max_tokens": { "type": "number" }, "model": { "type": "string" }, "structured_output_strategy": { "type": "string" }, "temperature": { "format": "float", "type": "number" }, "use_native_tools": { "type": "boolean" } }, "type": "object" }, "messages": { "items": { "properties": { "content": { "items": { "properties": { "artifact": { "properties": { "id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "meta": {}, "name": { "type": "string" }, "reference": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "name", "type", "value" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "artifact", "type" ], "type": "object" }, "type": "array" }, "role": { "type": "string" }, "usage": { "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "type": { "type": "string" } }, "required": [ "input_tokens", "output_tokens", "type" ], "type": "object" } }, "required": [ "content", "role", "usage" ], "type": "object" }, "type": "array" }, "output_schema": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "id": { "type": "string" }, "properties": { "properties": { "member": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "properties": "[Circular]", "required": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "properties", "required", "type" ], "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "schema": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "id", "properties", "required", "schema", "title", "type" ], "type": "object" }, "tools": { "items": { "properties": { "activities": { "items": { "properties": { "description": { "type": "string" }, "json_schema": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "id": { "type": "string" }, "properties": { "properties": { "member": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "properties": "[Circular]", "required": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "properties", "required", "type" ], "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "schema": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "id", "properties", "required", "schema", "title", "type" ], "type": "object" }, "name": { "type": "string" } }, "required": [ "description", "json_schema", "name" ], "type": "object" }, "type": "array" }, "name": { "type": "string" } }, "required": [ "activities", "name" ], "type": "object" }, "type": "array" } }, "required": [ "driver_configuration", "messages", "output_schema", "tools" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateChatMessageRequestContent | true | none |
Example responses
201 Response
{ "properties": { "content": { "items": { "properties": { "artifact": { "properties": { "id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "meta": {}, "name": { "type": "string" }, "reference": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "name", "type", "value" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "artifact", "type" ], "type": "object" }, "type": "array" }, "role": { "type": "string" }, "type": { "type": "string" }, "usage": { "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "type": { "type": "string" } }, "required": [ "input_tokens", "output_tokens", "type" ], "type": "object" } }, "required": [ "content", "role", "type", "usage" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateChatMessage 201 response | CreateChatMessageResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateChatMessageStream
POST /chat/messages/stream
Body parameter
{ "properties": { "driver_configuration": { "properties": { "extra_params": {}, "max_tokens": { "type": "number" }, "model": { "type": "string" }, "structured_output_strategy": { "type": "string" }, "temperature": { "format": "float", "type": "number" }, "use_native_tools": { "type": "boolean" } }, "type": "object" }, "messages": { "items": { "properties": { "content": { "items": { "properties": { "artifact": { "properties": { "id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "meta": {}, "name": { "type": "string" }, "reference": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "name", "type", "value" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "artifact", "type" ], "type": "object" }, "type": "array" }, "role": { "type": "string" }, "usage": { "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "type": { "type": "string" } }, "required": [ "input_tokens", "output_tokens", "type" ], "type": "object" } }, "required": [ "content", "role", "usage" ], "type": "object" }, "type": "array" }, "output_schema": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "id": { "type": "string" }, "properties": { "properties": { "member": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "properties": "[Circular]", "required": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "properties", "required", "type" ], "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "schema": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "id", "properties", "required", "schema", "title", "type" ], "type": "object" }, "tools": { "items": { "properties": { "activities": { "items": { "properties": { "description": { "type": "string" }, "json_schema": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "id": { "type": "string" }, "properties": { "properties": { "member": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "properties": "[Circular]", "required": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "properties", "required", "type" ], "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "schema": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "id", "properties", "required", "schema", "title", "type" ], "type": "object" }, "name": { "type": "string" } }, "required": [ "description", "json_schema", "name" ], "type": "object" }, "type": "array" }, "name": { "type": "string" } }, "required": [ "activities", "name" ], "type": "object" }, "type": "array" } }, "required": [ "driver_configuration", "messages", "output_schema", "tools" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateChatMessageStreamRequestContent | true | none |
Example responses
201 Response
{ "properties": { "content": { "items": { "properties": { "artifact": { "properties": { "id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "meta": {}, "name": { "type": "string" }, "reference": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "name", "type", "value" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "artifact", "type" ], "type": "object" }, "type": "array" }, "role": { "type": "string" }, "type": { "type": "string" }, "usage": { "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "type": { "type": "string" } }, "required": [ "input_tokens", "output_tokens", "type" ], "type": "object" } }, "required": [ "content", "role", "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateChatMessageStream 201 response | CreateChatMessageStreamResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Configs
GetConfig
GET /config
Example responses
200 Response
{ "properties": { "data_lake_s3_bucket": { "type": "string" }, "data_lake_s3_region": { "type": "string" }, "data_lake_s3_url": { "type": "string" }, "google_drive_data_connector_client_id": { "type": "string" } }, "required": [ "data_lake_s3_bucket", "data_lake_s3_region", "data_lake_s3_url", "google_drive_data_connector_client_id" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetConfig 200 response | GetConfigResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Connections
ListConnections
GET /connections
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
type | query | string | false | none |
Example responses
200 Response
{ "properties": { "connections": { "items": { "properties": { "connection_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "connection_id", "created_at", "created_by", "name", "type", "updated_at" ], "type": "object" }, "type": "array" } }, "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListConnections 200 response | ListConnectionsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateConnection
POST /connections
Body parameter
{ "properties": { "credentials": { "oneOf": [ { "properties": { "github": { "properties": { "auth_code": { "type": "string" } }, "required": [ "auth_code" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" } ] }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "credentials", "type" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateConnectionRequestContent | true | none |
Example responses
201 Response
{ "properties": { "connection_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" } }, "required": [ "connection_id", "created_at", "created_by", "name", "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateConnection 201 response | CreateConnectionResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteConnection
DELETE /connections/{connection_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
connection_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteConnection 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetToken
GET /connections/{connection_id}/access-token
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
connection_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "access_token": { "type": "string" } }, "required": [ "access_token" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetToken 200 response | GetTokenResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Structures
GetStructuresDashboard
GET /dashboards/structures
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
start_time | query | string(date-time) | false | none |
end_time | query | string(date-time) | false | none |
period | query | Period | false | none |
structure_ids | query | string | false | none |
Enumerated Values
Parameter | Value |
---|---|
period | 1m |
period | 1h |
period | 1d |
period | 1w |
Example responses
200 Response
{ "properties": { "deployment_count_gauge": { "properties": { "active_count": { "type": "number" }, "total_count": { "type": "number" } }, "type": "object" }, "deployment_duration_gauge": { "properties": { "total_seconds": { "type": "number" } }, "type": "object" }, "deployment_error_rate_gauge": { "properties": { "rate": { "format": "float", "type": "number" } }, "type": "object" }, "duration_plot": { "properties": { "seconds_avg": { "type": "number" }, "seconds_p100": { "type": "number" }, "seconds_p50": { "type": "number" }, "timeseries": { "items": { "properties": { "seconds_p0": { "type": "number" }, "seconds_p100": { "type": "number" }, "seconds_p50": { "type": "number" }, "time": { "format": "date-time", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "error_rate_gauge": { "properties": { "error_type_counts": { "items": { "properties": { "count": { "type": "number" }, "error_type": { "type": "string" } }, "type": "object" }, "type": "array" }, "rate": { "format": "float", "type": "number" } }, "type": "object" }, "run_count_gauge": { "properties": { "active_count": { "type": "number" }, "total_count": { "type": "number" } }, "type": "object" }, "run_duration_gauge": { "properties": { "activity_durations": { "items": { "properties": { "activity_type": { "type": "string" }, "seconds": { "type": "number" } }, "type": "object" }, "type": "array" }, "total_seconds": { "type": "number" } }, "type": "object" }, "token_count_gauge": { "properties": { "by_model": { "additionalProperties": { "properties": { "input": { "format": "float", "type": "number" }, "output": { "format": "float", "type": "number" } }, "type": "object" }, "type": "object" }, "input": { "format": "float", "type": "number" }, "output": { "format": "float", "type": "number" } }, "type": "object" } }, "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetStructuresDashboard 200 response | GetStructuresDashboardResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListStructures
GET /structures
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "structures": { "items": { "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_config_file": { "type": "string" }, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "webhook_enabled": { "type": "boolean" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "latest_deployment_id", "name", "organization_id", "structure_id", "updated_at", "webhook_enabled" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "structures" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListStructures 200 response | ListStructuresResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateStructure
POST /structures
Body parameter
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "structure_config_file": { "maxLength": 200, "minLength": 1, "type": "string" }, "webhook_enabled": { "type": "boolean" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateStructureRequestContent | true | none |
Example responses
201 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_config_file": { "type": "string" }, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "webhook_enabled": { "type": "boolean" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "latest_deployment_id", "name", "organization_id", "structure_id", "updated_at", "webhook_enabled" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateStructure 201 response | CreateStructureResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteStructure
DELETE /structures/{structure_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteStructure 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetStructure
GET /structures/{structure_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_config_file": { "type": "string" }, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "webhook_enabled": { "type": "boolean" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "latest_deployment_id", "name", "organization_id", "structure_id", "updated_at", "webhook_enabled" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetStructure 200 response | GetStructureResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateStructure
PATCH /structures/{structure_id}
Body parameter
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "structure_config_file": { "maxLength": 200, "minLength": 1, "type": "string" }, "webhook_enabled": { "type": "boolean" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_id | path | string | true | none |
body | body | UpdateStructureRequestContent | false | none |
Example responses
200 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_config_file": { "type": "string" }, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "webhook_enabled": { "type": "boolean" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "latest_deployment_id", "name", "organization_id", "structure_id", "updated_at", "webhook_enabled" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateStructure 200 response | UpdateStructureResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
InvokeStructureWebhookGet
GET /structures/{structure_id}/webhook
Invoke a webhook for a structure. Must have the webhook_enabled
flag set to true
.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_id | path | string | true | none |
api_key | query | string | false | none |
Example responses
200 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_config_file": { "type": "string" }, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "webhook_enabled": { "type": "boolean" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "latest_deployment_id", "name", "organization_id", "structure_id", "updated_at", "webhook_enabled" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | InvokeStructureWebhookGet 200 response | InvokeStructureWebhookGetResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
InvokeStructureWebhookPost
POST /structures/{structure_id}/webhook
Invoke a webhook for a structure, sending the POST body as the first Structure arg. Must have the webhook_enabled
flag set to true
.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_id | path | string | true | none |
api_key | query | string | false | none |
Example responses
200 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_config_file": { "type": "string" }, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "webhook_enabled": { "type": "boolean" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "latest_deployment_id", "name", "organization_id", "structure_id", "updated_at", "webhook_enabled" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | InvokeStructureWebhookPost 200 response | InvokeStructureWebhookPostResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DataConnectors
ListDataConnectors
GET /data-connectors
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "data_connectors": { "items": { "properties": { "bucket_id": { "type": "string" }, "config": { "oneOf": [ { "properties": { "confluence": { "properties": { "atlassian_email": { "type": "string" }, "domain": { "type": "string" } }, "required": [ "atlassian_email", "domain" ], "type": "object" } }, "required": [ "confluence" ], "title": "confluence", "type": "object" }, { "properties": { "google_drive": { "properties": { "access_token": { "type": "string" }, "file_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "access_token", "file_ids" ], "type": "object" } }, "required": [ "google_drive" ], "title": "google_drive", "type": "object" }, { "properties": { "webscraper": { "properties": { "urls": { "items": { "type": "string" }, "type": "array" } }, "required": [ "urls" ], "type": "object" } }, "required": [ "webscraper" ], "title": "webscraper", "type": "object" }, { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "required": [ "structure" ], "title": "structure", "type": "object" }, { "properties": { "s3": { "properties": { "aws_access_key_id": { "type": "string" }, "uris": { "items": { "type": "string" }, "type": "array" } }, "required": [ "aws_access_key_id", "uris" ], "type": "object" } }, "required": [ "s3" ], "title": "s3", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "bucket_id": { "type": "string" } }, "required": [ "asset_paths", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "schedule_expression": { "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "data_connector_id", "name", "organization_id", "type", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "data_connectors", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListDataConnectors 200 response | ListDataConnectorsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateDataConnector
POST /data-connectors
Body parameter
{ "properties": { "config": { "oneOf": [ { "properties": { "confluence": { "properties": { "atlassian_api_token": { "type": "string" }, "atlassian_email": { "type": "string" }, "domain": { "type": "string" } }, "required": [ "atlassian_api_token", "atlassian_email", "domain" ], "type": "object" } }, "required": [ "confluence" ], "title": "confluence", "type": "object" }, { "properties": { "google_drive": { "properties": { "auth_code": { "type": "string" }, "file_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "auth_code", "file_ids" ], "type": "object" } }, "required": [ "google_drive" ], "title": "google_drive", "type": "object" }, { "properties": { "webscraper": { "properties": { "urls": { "items": { "type": "string" }, "type": "array" } }, "required": [ "urls" ], "type": "object" } }, "required": [ "webscraper" ], "title": "webscraper", "type": "object" }, { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "required": [ "structure" ], "title": "structure", "type": "object" }, { "properties": { "s3": { "properties": { "aws_access_key_id": { "type": "string" }, "aws_secret_access_key": { "type": "string" }, "uris": { "items": { "type": "string" }, "type": "array" } }, "required": [ "aws_access_key_id", "aws_secret_access_key", "uris" ], "type": "object" } }, "required": [ "s3" ], "title": "s3", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "bucket_id": { "type": "string" } }, "required": [ "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "schedule_expression": { "maxLength": 200, "minLength": 1, "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "required": [ "structure" ], "type": "object" }, "type": "array" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "config", "name", "type" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateDataConnectorRequestContent | true | none |
Example responses
201 Response
{ "properties": { "config": { "oneOf": [ { "properties": { "confluence": { "properties": { "atlassian_email": { "type": "string" }, "domain": { "type": "string" } }, "required": [ "atlassian_email", "domain" ], "type": "object" } }, "required": [ "confluence" ], "title": "confluence", "type": "object" }, { "properties": { "google_drive": { "properties": { "access_token": { "type": "string" }, "file_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "access_token", "file_ids" ], "type": "object" } }, "required": [ "google_drive" ], "title": "google_drive", "type": "object" }, { "properties": { "webscraper": { "properties": { "urls": { "items": { "type": "string" }, "type": "array" } }, "required": [ "urls" ], "type": "object" } }, "required": [ "webscraper" ], "title": "webscraper", "type": "object" }, { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "required": [ "structure" ], "title": "structure", "type": "object" }, { "properties": { "s3": { "properties": { "aws_access_key_id": { "type": "string" }, "uris": { "items": { "type": "string" }, "type": "array" } }, "required": [ "aws_access_key_id", "uris" ], "type": "object" } }, "required": [ "s3" ], "title": "s3", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "bucket_id": { "type": "string" } }, "required": [ "asset_paths", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "data_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "schedule_expression": { "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "data_connector_id", "name", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateDataConnector 201 response | CreateDataConnectorResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteDataConnector
DELETE /data-connectors/{data_connector_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
data_connector_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteDataConnector 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetDataConnector
GET /data-connectors/{data_connector_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
data_connector_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "bucket_id": { "type": "string" }, "config": { "oneOf": [ { "properties": { "confluence": { "properties": { "atlassian_email": { "type": "string" }, "domain": { "type": "string" } }, "required": [ "atlassian_email", "domain" ], "type": "object" } }, "required": [ "confluence" ], "title": "confluence", "type": "object" }, { "properties": { "google_drive": { "properties": { "access_token": { "type": "string" }, "file_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "access_token", "file_ids" ], "type": "object" } }, "required": [ "google_drive" ], "title": "google_drive", "type": "object" }, { "properties": { "webscraper": { "properties": { "urls": { "items": { "type": "string" }, "type": "array" } }, "required": [ "urls" ], "type": "object" } }, "required": [ "webscraper" ], "title": "webscraper", "type": "object" }, { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "required": [ "structure" ], "title": "structure", "type": "object" }, { "properties": { "s3": { "properties": { "aws_access_key_id": { "type": "string" }, "uris": { "items": { "type": "string" }, "type": "array" } }, "required": [ "aws_access_key_id", "uris" ], "type": "object" } }, "required": [ "s3" ], "title": "s3", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "bucket_id": { "type": "string" } }, "required": [ "asset_paths", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "schedule_expression": { "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "data_connector_id", "name", "organization_id", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetDataConnector 200 response | GetDataConnectorResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateDataConnector
PATCH /data-connectors/{data_connector_id}
Body parameter
{ "properties": { "config": { "oneOf": [ { "properties": { "confluence": { "properties": { "atlassian_api_token": { "type": "string" }, "atlassian_email": { "type": "string" }, "domain": { "type": "string" } }, "required": [ "atlassian_api_token", "atlassian_email", "domain" ], "type": "object" } }, "required": [ "confluence" ], "title": "confluence", "type": "object" }, { "properties": { "google_drive": { "properties": { "auth_code": { "type": "string" }, "file_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "auth_code", "file_ids" ], "type": "object" } }, "required": [ "google_drive" ], "title": "google_drive", "type": "object" }, { "properties": { "webscraper": { "properties": { "urls": { "items": { "type": "string" }, "type": "array" } }, "required": [ "urls" ], "type": "object" } }, "required": [ "webscraper" ], "title": "webscraper", "type": "object" }, { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "required": [ "structure" ], "title": "structure", "type": "object" }, { "properties": { "s3": { "properties": { "aws_access_key_id": { "type": "string" }, "aws_secret_access_key": { "type": "string" }, "uris": { "items": { "type": "string" }, "type": "array" } }, "required": [ "aws_access_key_id", "aws_secret_access_key", "uris" ], "type": "object" } }, "required": [ "s3" ], "title": "s3", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "bucket_id": { "type": "string" } }, "required": [ "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "schedule_expression": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
data_connector_id | path | string | true | none |
body | body | UpdateDataConnectorRequestContent | false | none |
Example responses
200 Response
{ "properties": { "config": { "oneOf": [ { "properties": { "confluence": { "properties": { "atlassian_email": { "type": "string" }, "domain": { "type": "string" } }, "required": [ "atlassian_email", "domain" ], "type": "object" } }, "required": [ "confluence" ], "title": "confluence", "type": "object" }, { "properties": { "google_drive": { "properties": { "access_token": { "type": "string" }, "file_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "access_token", "file_ids" ], "type": "object" } }, "required": [ "google_drive" ], "title": "google_drive", "type": "object" }, { "properties": { "webscraper": { "properties": { "urls": { "items": { "type": "string" }, "type": "array" } }, "required": [ "urls" ], "type": "object" } }, "required": [ "webscraper" ], "title": "webscraper", "type": "object" }, { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "required": [ "structure" ], "title": "structure", "type": "object" }, { "properties": { "s3": { "properties": { "aws_access_key_id": { "type": "string" }, "uris": { "items": { "type": "string" }, "type": "array" } }, "required": [ "aws_access_key_id", "uris" ], "type": "object" } }, "required": [ "s3" ], "title": "s3", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "bucket_id": { "type": "string" } }, "required": [ "asset_paths", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "data_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "schedule_expression": { "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "data_connector_id", "name", "organization_id", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateDataConnector 200 response | UpdateDataConnectorResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DataJobs
ListDataJobs
GET /data-connectors/{data_connector_id}/data-jobs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
data_connector_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
status | query | array[string] | false | Comma-separated list of statuses to filter by. |
Enumerated Values
Parameter | Value |
---|---|
status | QUEUED |
status | RUNNING |
status | SUCCEEDED |
status | FAILED |
status | CANCELLED |
Example responses
200 Response
{ "properties": { "data_jobs": { "items": { "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "data_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "data_connector_id", "data_job_id", "status" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "data_jobs", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListDataJobs 200 response | ListDataJobsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateDataJob
POST /data-connectors/{data_connector_id}/data-jobs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
data_connector_id | path | string | true | none |
Example responses
202 Response
{ "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "data_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "data_connector_id", "data_job_id", "status" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
202 | Accepted | CreateDataJob 202 response | CreateDataJobResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetDataJob
GET /data-jobs/{data_job_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
data_job_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "data_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "data_connector_id", "data_job_id", "status" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetDataJob 200 response | GetDataJobResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CancelDataJob
POST /data-jobs/{data_job_id}/cancel
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
data_job_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "data_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "data_connector_id", "data_job_id", "status" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | CancelDataJob 200 response | CancelDataJobResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Deployments
GetDeployment
GET /deployments/{deployment_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
deployment_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "function_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "DEPLOYING", "SUCCEEDED", "FAILED", "ERROR" ], "type": "string" }, "status_detail": {}, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "code_source", "created_at", "created_by", "deployment_id", "status" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetDeployment 200 response | GetDeploymentResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListFunctionDeployments
GET /functions/{function_id}/deployments
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
function_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "deployments": { "items": { "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "function_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "DEPLOYING", "SUCCEEDED", "FAILED", "ERROR" ], "type": "string" }, "status_detail": {} }, "required": [ "code_source", "created_at", "created_by", "deployment_id", "function_id", "status" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "deployments", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListFunctionDeployments 200 response | ListFunctionDeploymentsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateFunctionDeployment
POST /functions/{function_id}/deployments
Body parameter
{ "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "access_token": { "maxLength": 1000, "minLength": 1, "type": "string" }, "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" } ] }, "force": { "type": "boolean" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
function_id | path | string | true | none |
body | body | CreateFunctionDeploymentRequestContent | false | none |
Example responses
202 Response
{ "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "function_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "DEPLOYING", "SUCCEEDED", "FAILED", "ERROR" ], "type": "string" }, "status_detail": {} }, "required": [ "code_source", "created_at", "created_by", "deployment_id", "function_id", "status" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
202 | Accepted | CreateFunctionDeployment 202 response | CreateFunctionDeploymentResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListStructureDeployments
GET /structures/{structure_id}/deployments
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
status | query | array[string] | false | Comma-separated list of deployment statuses to filter by. |
Enumerated Values
Parameter | Value |
---|---|
status | QUEUED |
status | DEPLOYING |
status | SUCCEEDED |
status | FAILED |
status | ERROR |
Example responses
200 Response
{ "properties": { "deployments": { "items": { "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "DEPLOYING", "SUCCEEDED", "FAILED", "ERROR" ], "type": "string" }, "status_detail": {}, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "code_source", "created_at", "created_by", "deployment_id", "status", "structure_id" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "deployments", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListStructureDeployments 200 response | ListStructureDeploymentsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateStructureDeployment
POST /structures/{structure_id}/deployments
Body parameter
{ "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "access_token": { "maxLength": 1000, "minLength": 1, "type": "string" }, "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" } ] }, "force": { "type": "boolean" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_id | path | string | true | none |
body | body | CreateStructureDeploymentRequestContent | false | none |
Example responses
202 Response
{ "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "DEPLOYING", "SUCCEEDED", "FAILED", "ERROR" ], "type": "string" }, "status_detail": {}, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "code_source", "created_at", "created_by", "deployment_id", "status", "structure_id" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
202 | Accepted | CreateStructureDeployment 202 response | CreateStructureDeploymentResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListToolDeployments
GET /tools/{tool_id}/deployments
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
tool_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "deployments": { "items": { "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "DEPLOYING", "SUCCEEDED", "FAILED", "ERROR" ], "type": "string" }, "status_detail": {}, "tool_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "code_source", "created_at", "created_by", "deployment_id", "status", "tool_id" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "deployments", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListToolDeployments 200 response | ListToolDeploymentsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateToolDeployment
POST /tools/{tool_id}/deployments
Body parameter
{ "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "access_token": { "maxLength": 1000, "minLength": 1, "type": "string" }, "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" } ] }, "force": { "type": "boolean" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
tool_id | path | string | true | none |
body | body | CreateToolDeploymentRequestContent | false | none |
Example responses
202 Response
{ "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "DEPLOYING", "SUCCEEDED", "FAILED", "ERROR" ], "type": "string" }, "status_detail": {}, "tool_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "code_source", "created_at", "created_by", "deployment_id", "status", "tool_id" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
202 | Accepted | CreateToolDeployment 202 response | CreateToolDeploymentResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
FunctionRuns
GetFunctionRun
GET /function-runs/{function_run_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
function_run_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "function_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "function_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "input": {}, "output": {}, "output_timestamp": { "format": "double", "type": "number" }, "runtime_path": { "type": "string" }, "started_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "completed_at", "created_at", "created_by", "function_id", "function_run_id", "input", "runtime_path", "started_at", "status", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetFunctionRun 200 response | GetFunctionRunResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListFunctionRunLogs
GET /function-runs/{function_run_id}/logs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
function_run_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "logs": { "items": { "type": "string" }, "type": "array" } }, "required": [ "logs" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListFunctionRunLogs 200 response | ListFunctionRunLogsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListFunctionRuns
GET /functions/{function_id}/runs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
function_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
status | query | array[string] | false | Comma-separated list of run statuses to filter by. |
Enumerated Values
Parameter | Value |
---|---|
status | QUEUED |
status | STARTING |
status | RUNNING |
status | SUCCEEDED |
status | FAILED |
status | ERROR |
status | CANCELLED |
Example responses
200 Response
{ "properties": { "function_runs": { "items": { "properties": { "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "function_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "function_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "input": {}, "output": {}, "output_timestamp": { "format": "double", "type": "number" }, "runtime_path": { "type": "string" }, "started_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "completed_at", "created_at", "created_by", "function_id", "function_run_id", "input", "runtime_path", "started_at", "status", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "function_runs", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListFunctionRuns 200 response | ListFunctionRunsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Functions
ListFunctions
GET /functions
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "functions": { "items": { "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "function_config_file": { "type": "string" }, "function_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "function_id", "latest_deployment_id", "name", "organization_id", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "functions", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListFunctions 200 response | ListFunctionsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateFunction
POST /functions
Body parameter
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "function_config_file": { "maxLength": 200, "minLength": 1, "type": "string" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateFunctionRequestContent | true | none |
Example responses
201 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "function_config_file": { "type": "string" }, "function_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "function_id", "latest_deployment_id", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateFunction 201 response | CreateFunctionResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteFunction
DELETE /functions/{function_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
function_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteFunction 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetFunction
GET /functions/{function_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
function_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "function_config_file": { "type": "string" }, "function_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "function_id", "latest_deployment_id", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetFunction 200 response | GetFunctionResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateFunction
PATCH /functions/{function_id}
Body parameter
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "function_config_file": { "maxLength": 200, "minLength": 1, "type": "string" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
function_id | path | string | true | none |
body | body | UpdateFunctionRequestContent | false | none |
Example responses
200 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "function_config_file": { "type": "string" }, "function_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "function_id", "latest_deployment_id", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateFunction 200 response | UpdateFunctionResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
FunctionExecute
CreateFunctionExecutionGet
GET /functions/{function_id}/execute
Executes the function with the given input. Query parameters are passed as 'query_params' to the function.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
function_id | path | string | true | none |
Example responses
200 Response
{}
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | CreateFunctionExecutionGet 200 response | CreateFunctionExecutionGetOutputPayload |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateFunctionExecutionPost
POST /functions/{function_id}/execute
Executes the function with the given input. Input body is passed as 'body' to the function. Query parameters are passed as 'query_params'.
Body parameter
{}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
function_id | path | string | true | none |
body | body | CreateFunctionExecutionPostInputPayload | false | none |
Example responses
200 Response
{}
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | CreateFunctionExecutionPost 200 response | CreateFunctionExecutionPostOutputPayload |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Integrations
ListIntegrations
GET /integrations
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "integrations": { "items": { "properties": { "assistant_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "slack": { "properties": { "app_description": { "type": "string" }, "app_display_name": { "type": "string" }, "app_manifest": {}, "app_name": { "type": "string" }, "bot_token_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "signing_secret_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "app_description", "app_display_name", "app_manifest", "app_name", "bot_token_secret_ref", "signing_secret_secret_ref" ], "type": "object" } }, "required": [ "slack" ], "title": "slack", "type": "object" }, { "properties": { "github_app": { "properties": { "app_id": { "type": "string" }, "integration_endpoint": { "type": "string" }, "private_key_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "webhook_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "app_id", "integration_endpoint", "private_key_secret_ref", "webhook_secret_ref" ], "type": "object" } }, "required": [ "github_app" ], "title": "github_app", "type": "object" }, { "properties": { "webhook": { "properties": { "disable_api_key_param": { "type": "boolean" }, "integration_endpoint": { "type": "string" } }, "required": [ "disable_api_key_param", "integration_endpoint" ], "type": "object" } }, "required": [ "webhook" ], "title": "webhook", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "integration_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "type": { "enum": [ "slack", "github_app", "webhook" ], "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_ids", "config", "created_at", "created_by", "description", "integration_id", "name", "organization_id", "structure_ids", "type", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "integrations", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListIntegrations 200 response | ListIntegrationsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateIntegration
POST /integrations
Body parameter
{ "properties": { "assistant_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "slack": { "properties": { "app_description": { "type": "string" }, "app_display_name": { "type": "string" }, "app_name": { "type": "string" }, "bot_token_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "signing_secret_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "app_description", "app_display_name", "app_name" ], "type": "object" } }, "required": [ "slack" ], "title": "slack", "type": "object" }, { "properties": { "github_app": { "properties": { "app_id": { "type": "string" }, "private_key_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "webhook_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "type": "object" } }, "required": [ "github_app" ], "title": "github_app", "type": "object" }, { "properties": { "webhook": { "properties": { "disable_api_key_param": { "type": "boolean" } }, "type": "object" } }, "required": [ "webhook" ], "title": "webhook", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "type": { "enum": [ "slack", "github_app", "webhook" ], "type": "string" } }, "required": [ "config", "name", "type" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateIntegrationRequestContent | true | none |
Example responses
201 Response
{ "properties": { "assistant_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "slack": { "properties": { "app_description": { "type": "string" }, "app_display_name": { "type": "string" }, "app_manifest": {}, "app_name": { "type": "string" }, "bot_token_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "signing_secret_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "app_description", "app_display_name", "app_manifest", "app_name", "bot_token_secret_ref", "signing_secret_secret_ref" ], "type": "object" } }, "required": [ "slack" ], "title": "slack", "type": "object" }, { "properties": { "github_app": { "properties": { "app_id": { "type": "string" }, "integration_endpoint": { "type": "string" }, "private_key_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "webhook_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "app_id", "integration_endpoint", "private_key_secret_ref", "webhook_secret_ref" ], "type": "object" } }, "required": [ "github_app" ], "title": "github_app", "type": "object" }, { "properties": { "webhook": { "properties": { "disable_api_key_param": { "type": "boolean" }, "integration_endpoint": { "type": "string" } }, "required": [ "disable_api_key_param", "integration_endpoint" ], "type": "object" } }, "required": [ "webhook" ], "title": "webhook", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "integration_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "type": { "enum": [ "slack", "github_app", "webhook" ], "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_ids", "config", "created_at", "created_by", "description", "integration_id", "name", "organization_id", "structure_ids", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateIntegration 201 response | CreateIntegrationResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteIntegration
DELETE /integrations/{integration_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
integration_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteIntegration 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetIntegration
GET /integrations/{integration_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
integration_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "assistant_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "slack": { "properties": { "app_description": { "type": "string" }, "app_display_name": { "type": "string" }, "app_manifest": {}, "app_name": { "type": "string" }, "bot_token_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "signing_secret_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "app_description", "app_display_name", "app_manifest", "app_name", "bot_token_secret_ref", "signing_secret_secret_ref" ], "type": "object" } }, "required": [ "slack" ], "title": "slack", "type": "object" }, { "properties": { "github_app": { "properties": { "app_id": { "type": "string" }, "integration_endpoint": { "type": "string" }, "private_key_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "webhook_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "app_id", "integration_endpoint", "private_key_secret_ref", "webhook_secret_ref" ], "type": "object" } }, "required": [ "github_app" ], "title": "github_app", "type": "object" }, { "properties": { "webhook": { "properties": { "disable_api_key_param": { "type": "boolean" }, "integration_endpoint": { "type": "string" } }, "required": [ "disable_api_key_param", "integration_endpoint" ], "type": "object" } }, "required": [ "webhook" ], "title": "webhook", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "integration_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "type": { "enum": [ "slack", "github_app", "webhook" ], "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_ids", "config", "created_at", "created_by", "description", "integration_id", "name", "organization_id", "structure_ids", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetIntegration 200 response | GetIntegrationResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateIntegration
PATCH /integrations/{integration_id}
Body parameter
{ "properties": { "assistant_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "slack": { "properties": { "app_description": { "type": "string" }, "app_display_name": { "type": "string" }, "app_name": { "type": "string" }, "bot_token_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "signing_secret_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "app_description", "app_display_name", "app_name" ], "type": "object" } }, "required": [ "slack" ], "title": "slack", "type": "object" }, { "properties": { "github_app": { "properties": { "app_id": { "type": "string" }, "private_key_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "webhook_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "type": "object" } }, "required": [ "github_app" ], "title": "github_app", "type": "object" }, { "properties": { "webhook": { "properties": { "disable_api_key_param": { "type": "boolean" } }, "type": "object" } }, "required": [ "webhook" ], "title": "webhook", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "type": { "enum": [ "slack", "github_app", "webhook" ], "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
integration_id | path | string | true | none |
body | body | UpdateIntegrationRequestContent | false | none |
Example responses
200 Response
{ "properties": { "assistant_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "slack": { "properties": { "app_description": { "type": "string" }, "app_display_name": { "type": "string" }, "app_manifest": {}, "app_name": { "type": "string" }, "bot_token_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "signing_secret_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "app_description", "app_display_name", "app_manifest", "app_name", "bot_token_secret_ref", "signing_secret_secret_ref" ], "type": "object" } }, "required": [ "slack" ], "title": "slack", "type": "object" }, { "properties": { "github_app": { "properties": { "app_id": { "type": "string" }, "integration_endpoint": { "type": "string" }, "private_key_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "webhook_secret_ref": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "app_id", "integration_endpoint", "private_key_secret_ref", "webhook_secret_ref" ], "type": "object" } }, "required": [ "github_app" ], "title": "github_app", "type": "object" }, { "properties": { "webhook": { "properties": { "disable_api_key_param": { "type": "boolean" }, "integration_endpoint": { "type": "string" } }, "required": [ "disable_api_key_param", "integration_endpoint" ], "type": "object" } }, "required": [ "webhook" ], "title": "webhook", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "integration_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "type": { "enum": [ "slack", "github_app", "webhook" ], "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_ids", "config", "created_at", "created_by", "description", "integration_id", "name", "organization_id", "structure_ids", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateIntegration 200 response | UpdateIntegrationResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Invites
ListUserInvites
GET /invites
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "invites": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "email": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "invite_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "responded_at": { "format": "date-time", "type": "string" }, "status": { "enum": [ "ACCEPTED", "EXPIRED", "PENDING", "REJECTED" ], "type": "string" } }, "required": [ "created_at", "created_by", "email", "expires_at", "invite_id", "organization_id", "status" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "invites", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListUserInvites 200 response | ListUserInvitesResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteInvite
DELETE /invites/{invite_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
invite_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteInvite 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetInvite
GET /invites/{invite_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
invite_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "email": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "invite_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "responded_at": { "format": "date-time", "type": "string" }, "status": { "enum": [ "ACCEPTED", "EXPIRED", "PENDING", "REJECTED" ], "type": "string" } }, "required": [ "created_at", "created_by", "email", "expires_at", "invite_id", "organization_id", "status" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetInvite 200 response | GetInviteResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
RespondToInvite
POST /invites/{invite_id}/response
Body parameter
{ "properties": { "response": { "enum": [ "ACCEPTED", "REJECTED" ], "type": "string" } }, "required": [ "response" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
invite_id | path | string | true | none |
body | body | RespondToInviteRequestContent | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | RespondToInvite 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListInvites
GET /organizations/{organization_id}/invites
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
organization_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "invites": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "email": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "invite_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "responded_at": { "format": "date-time", "type": "string" }, "status": { "enum": [ "ACCEPTED", "EXPIRED", "PENDING", "REJECTED" ], "type": "string" } }, "required": [ "created_at", "created_by", "email", "expires_at", "invite_id", "organization_id", "status" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "invites", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListInvites 200 response | ListInvitesResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateInvite
POST /organizations/{organization_id}/invites
Body parameter
{ "properties": { "email": { "maxLength": 254, "minLength": 1, "type": "string" } }, "required": [ "email" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
organization_id | path | string | true | none |
body | body | CreateInviteRequestContent | true | none |
Example responses
201 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "email": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "invite_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "responded_at": { "format": "date-time", "type": "string" }, "status": { "enum": [ "ACCEPTED", "EXPIRED", "PENDING", "REJECTED" ], "type": "string" } }, "required": [ "created_at", "created_by", "email", "expires_at", "invite_id", "organization_id", "status" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateInvite 201 response | CreateInviteResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
KnowledgeBaseJobs
GetKnowledgeBaseJob
GET /knowledge-base-jobs/{knowledge_base_job_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_job_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "knowledge_base_id", "knowledge_base_job_id", "status" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetKnowledgeBaseJob 200 response | GetKnowledgeBaseJobResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CancelKnowledgeBaseJob
POST /knowledge-base-jobs/{knowledge_base_job_id}/cancel
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_job_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "knowledge_base_id", "knowledge_base_job_id", "status" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | CancelKnowledgeBaseJob 200 response | CancelKnowledgeBaseJobResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListKnowledgeBaseJobs
GET /knowledge-bases/{knowledge_base_id}/knowledge-base-jobs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
status | query | array[string] | false | Comma-separated list of statuses to filter by. |
Enumerated Values
Parameter | Value |
---|---|
status | QUEUED |
status | RUNNING |
status | SUCCEEDED |
status | FAILED |
status | CANCELLED |
Example responses
200 Response
{ "properties": { "knowledge_base_jobs": { "items": { "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "knowledge_base_id", "knowledge_base_job_id", "status" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "knowledge_base_jobs", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListKnowledgeBaseJobs 200 response | ListKnowledgeBaseJobsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateKnowledgeBaseJob
POST /knowledge-bases/{knowledge_base_id}/knowledge-base-jobs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_id | path | string | true | none |
Example responses
202 Response
{ "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "knowledge_base_id", "knowledge_base_job_id", "status" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
202 | Accepted | CreateKnowledgeBaseJob 202 response | CreateKnowledgeBaseJobResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
KnowledgeBases
GetKnowledgeBaseQuery
GET /knowledge-base-queries/{knowledge_base_query_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_query_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "entries": { "items": { "properties": { "id": { "type": "string" }, "meta": { "additionalProperties": { "type": "string" }, "type": "object" }, "namespace": { "type": "string" }, "score": { "format": "float", "type": "number" }, "vector": { "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "id", "score" ], "type": "object" }, "type": "array" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_query_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "query": { "type": "string" } }, "required": [ "created_at", "created_by", "entries", "knowledge_base_id", "knowledge_base_query_id", "query" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetKnowledgeBaseQuery 200 response | GetKnowledgeBaseQueryResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetKnowledgeBaseSearch
GET /knowledge-base-searches/{knowledge_base_search_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_search_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_search_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "query": { "type": "string" }, "result": { "type": "string" } }, "required": [ "created_at", "created_by", "knowledge_base_id", "knowledge_base_search_id", "query", "result" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetKnowledgeBaseSearch 200 response | GetKnowledgeBaseSearchResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListKnowledgeBases
GET /knowledge-bases
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "knowledge_bases": { "items": { "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "pg_vector": { "properties": { "connection_string": { "type": "string" }, "embedding_model": { "type": "string" }, "query_schema": {}, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "connection_string", "embedding_model", "query_schema", "use_default_embedding_model" ], "type": "object" } }, "required": [ "pg_vector" ], "title": "pg_vector", "type": "object" }, { "properties": { "gtc_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "query_schema": {}, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "embedding_model", "query_schema", "use_default_embedding_model" ], "type": "object" } }, "required": [ "gtc_pg_vector" ], "title": "gtc_pg_vector", "type": "object" }, { "properties": { "gtc_hybrid_sql_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "query_schema": {}, "structured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "sql_type": { "type": "string" } }, "required": [ "column_name", "sql_type" ], "type": "object" }, "type": "array" }, "unstructured_columns": { "items": { "properties": { "column_name": { "type": "string" } }, "required": [ "column_name" ], "type": "object" }, "type": "array" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "embedding_model", "query_schema", "structured_columns", "unstructured_columns", "use_default_embedding_model" ], "type": "object" } }, "required": [ "gtc_hybrid_sql_pg_vector" ], "title": "gtc_hybrid_sql_pg_vector", "type": "object" }, { "properties": { "pgai_knowledge_base": { "properties": { "knowledge_base_name": { "type": "string" }, "query_schema": {} }, "required": [ "knowledge_base_name", "query_schema" ], "type": "object" } }, "required": [ "pgai_knowledge_base" ], "title": "pgai_knowledge_base", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "embedding_model": { "enum": [ "text-embedding-ada-002", "text-embedding-3-small" ], "type": "string" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "schedule_expression": { "maxLength": 200, "minLength": 1, "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "type": "object" }, "type": "array" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "asset_paths", "config", "created_at", "created_by", "knowledge_base_id", "name", "organization_id", "type", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "knowledge_bases", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListKnowledgeBases 200 response | ListKnowledgeBasesResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateKnowledgeBase
POST /knowledge-bases
Body parameter
{ "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "pg_vector": { "properties": { "connection_string": { "type": "string" }, "embedding_model": { "type": "string" }, "password": { "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "connection_string", "password" ], "type": "object" } }, "required": [ "pg_vector" ], "title": "pg_vector", "type": "object" }, { "properties": { "gtc_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "type": "object" } }, "required": [ "gtc_pg_vector" ], "title": "gtc_pg_vector", "type": "object" }, { "properties": { "gtc_hybrid_sql_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "structured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "description": { "type": "string" }, "sql_type": { "type": "string" } }, "required": [ "column_name", "description", "sql_type" ], "type": "object" }, "type": "array" }, "unstructured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "description": { "type": "string" } }, "required": [ "column_name", "description" ], "type": "object" }, "type": "array" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "structured_columns", "unstructured_columns" ], "type": "object" } }, "required": [ "gtc_hybrid_sql_pg_vector" ], "title": "gtc_hybrid_sql_pg_vector", "type": "object" }, { "properties": { "pgai_knowledge_base": { "type": "object" } }, "required": [ "pgai_knowledge_base" ], "title": "pgai_knowledge_base", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "embedding_model": { "enum": [ "text-embedding-ada-002", "text-embedding-3-small" ], "type": "string" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "type": "object" }, "type": "array" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "config", "name", "type" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateKnowledgeBaseRequestContent | true | none |
Example responses
201 Response
{ "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "pg_vector": { "properties": { "connection_string": { "type": "string" }, "embedding_model": { "type": "string" }, "query_schema": {}, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "connection_string", "embedding_model", "query_schema", "use_default_embedding_model" ], "type": "object" } }, "required": [ "pg_vector" ], "title": "pg_vector", "type": "object" }, { "properties": { "gtc_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "query_schema": {}, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "embedding_model", "query_schema", "use_default_embedding_model" ], "type": "object" } }, "required": [ "gtc_pg_vector" ], "title": "gtc_pg_vector", "type": "object" }, { "properties": { "gtc_hybrid_sql_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "query_schema": {}, "structured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "sql_type": { "type": "string" } }, "required": [ "column_name", "sql_type" ], "type": "object" }, "type": "array" }, "unstructured_columns": { "items": { "properties": { "column_name": { "type": "string" } }, "required": [ "column_name" ], "type": "object" }, "type": "array" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "embedding_model", "query_schema", "structured_columns", "unstructured_columns", "use_default_embedding_model" ], "type": "object" } }, "required": [ "gtc_hybrid_sql_pg_vector" ], "title": "gtc_hybrid_sql_pg_vector", "type": "object" }, { "properties": { "pgai_knowledge_base": { "properties": { "knowledge_base_name": { "type": "string" }, "query_schema": {} }, "required": [ "knowledge_base_name", "query_schema" ], "type": "object" } }, "required": [ "pgai_knowledge_base" ], "title": "pgai_knowledge_base", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "embedding_model": { "enum": [ "text-embedding-ada-002", "text-embedding-3-small" ], "type": "string" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "schedule_expression": { "maxLength": 200, "minLength": 1, "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "type": "object" }, "type": "array" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "asset_paths", "config", "created_at", "created_by", "knowledge_base_id", "name", "organization_id", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateKnowledgeBase 201 response | CreateKnowledgeBaseResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteKnowledgeBase
DELETE /knowledge-bases/{knowledge_base_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteKnowledgeBase 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetKnowledgeBase
GET /knowledge-bases/{knowledge_base_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "pg_vector": { "properties": { "connection_string": { "type": "string" }, "embedding_model": { "type": "string" }, "query_schema": {}, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "connection_string", "embedding_model", "query_schema", "use_default_embedding_model" ], "type": "object" } }, "required": [ "pg_vector" ], "title": "pg_vector", "type": "object" }, { "properties": { "gtc_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "query_schema": {}, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "embedding_model", "query_schema", "use_default_embedding_model" ], "type": "object" } }, "required": [ "gtc_pg_vector" ], "title": "gtc_pg_vector", "type": "object" }, { "properties": { "gtc_hybrid_sql_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "query_schema": {}, "structured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "sql_type": { "type": "string" } }, "required": [ "column_name", "sql_type" ], "type": "object" }, "type": "array" }, "unstructured_columns": { "items": { "properties": { "column_name": { "type": "string" } }, "required": [ "column_name" ], "type": "object" }, "type": "array" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "embedding_model", "query_schema", "structured_columns", "unstructured_columns", "use_default_embedding_model" ], "type": "object" } }, "required": [ "gtc_hybrid_sql_pg_vector" ], "title": "gtc_hybrid_sql_pg_vector", "type": "object" }, { "properties": { "pgai_knowledge_base": { "properties": { "knowledge_base_name": { "type": "string" }, "query_schema": {} }, "required": [ "knowledge_base_name", "query_schema" ], "type": "object" } }, "required": [ "pgai_knowledge_base" ], "title": "pgai_knowledge_base", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "embedding_model": { "enum": [ "text-embedding-ada-002", "text-embedding-3-small" ], "type": "string" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "schedule_expression": { "maxLength": 200, "minLength": 1, "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "type": "object" }, "type": "array" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "asset_paths", "config", "created_at", "created_by", "knowledge_base_id", "name", "organization_id", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetKnowledgeBase 200 response | GetKnowledgeBaseResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateKnowledgeBase
PATCH /knowledge-bases/{knowledge_base_id}
Body parameter
{ "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "pg_vector": { "properties": { "connection_string": { "type": "string" }, "embedding_model": { "type": "string" }, "password": { "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "connection_string", "password" ], "type": "object" } }, "required": [ "pg_vector" ], "title": "pg_vector", "type": "object" }, { "properties": { "gtc_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "type": "object" } }, "required": [ "gtc_pg_vector" ], "title": "gtc_pg_vector", "type": "object" }, { "properties": { "gtc_hybrid_sql_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "structured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "description": { "type": "string" }, "sql_type": { "type": "string" } }, "required": [ "column_name", "description", "sql_type" ], "type": "object" }, "type": "array" }, "unstructured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "description": { "type": "string" } }, "required": [ "column_name", "description" ], "type": "object" }, "type": "array" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "structured_columns", "unstructured_columns" ], "type": "object" } }, "required": [ "gtc_hybrid_sql_pg_vector" ], "title": "gtc_hybrid_sql_pg_vector", "type": "object" }, { "properties": { "pgai_knowledge_base": { "type": "object" } }, "required": [ "pgai_knowledge_base" ], "title": "pgai_knowledge_base", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "embedding_model": { "enum": [ "text-embedding-ada-002", "text-embedding-3-small" ], "type": "string" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "schedule_expression": { "maxLength": 200, "minLength": 1, "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "type": "object" }, "type": "array" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "config", "type" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_id | path | string | true | none |
body | body | UpdateKnowledgeBaseRequestContent | true | none |
Example responses
200 Response
{ "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "config": { "oneOf": [ { "properties": { "pg_vector": { "properties": { "connection_string": { "type": "string" }, "embedding_model": { "type": "string" }, "query_schema": {}, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "connection_string", "embedding_model", "query_schema", "use_default_embedding_model" ], "type": "object" } }, "required": [ "pg_vector" ], "title": "pg_vector", "type": "object" }, { "properties": { "gtc_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "query_schema": {}, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "embedding_model", "query_schema", "use_default_embedding_model" ], "type": "object" } }, "required": [ "gtc_pg_vector" ], "title": "gtc_pg_vector", "type": "object" }, { "properties": { "gtc_hybrid_sql_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "query_schema": {}, "structured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "sql_type": { "type": "string" } }, "required": [ "column_name", "sql_type" ], "type": "object" }, "type": "array" }, "unstructured_columns": { "items": { "properties": { "column_name": { "type": "string" } }, "required": [ "column_name" ], "type": "object" }, "type": "array" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "embedding_model", "query_schema", "structured_columns", "unstructured_columns", "use_default_embedding_model" ], "type": "object" } }, "required": [ "gtc_hybrid_sql_pg_vector" ], "title": "gtc_hybrid_sql_pg_vector", "type": "object" }, { "properties": { "pgai_knowledge_base": { "properties": { "knowledge_base_name": { "type": "string" }, "query_schema": {} }, "required": [ "knowledge_base_name", "query_schema" ], "type": "object" } }, "required": [ "pgai_knowledge_base" ], "title": "pgai_knowledge_base", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "embedding_model": { "enum": [ "text-embedding-ada-002", "text-embedding-3-small" ], "type": "string" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "schedule_expression": { "maxLength": 200, "minLength": 1, "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "type": "object" }, "type": "array" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "asset_paths", "config", "created_at", "created_by", "knowledge_base_id", "name", "organization_id", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateKnowledgeBase 200 response | UpdateKnowledgeBaseResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListKnowledgeBaseQueries
GET /knowledge-bases/{knowledge_base_id}/queries
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "knowledge_base_queries": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "entries": { "items": { "properties": { "id": { "type": "string" }, "meta": { "additionalProperties": { "type": "string" }, "type": "object" }, "namespace": { "type": "string" }, "score": { "format": "float", "type": "number" }, "vector": { "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "id", "score" ], "type": "object" }, "type": "array" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_query_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "query": { "type": "string" } }, "required": [ "created_at", "created_by", "entries", "knowledge_base_id", "knowledge_base_query_id", "query" ], "type": "object" }, "type": "array" } }, "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListKnowledgeBaseQueries 200 response | ListKnowledgeBaseQueriesResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
QueryKnowledgeBase
POST /knowledge-bases/{knowledge_base_id}/query
Body parameter
{ "properties": { "query": { "type": "string" }, "query_args": {} }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_id | path | string | true | none |
body | body | QueryKnowledgeBaseRequestContent | false | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "entries": { "items": { "properties": { "id": { "type": "string" }, "meta": { "additionalProperties": { "type": "string" }, "type": "object" }, "namespace": { "type": "string" }, "score": { "format": "float", "type": "number" }, "vector": { "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "id", "score" ], "type": "object" }, "type": "array" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_query_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "query": { "type": "string" } }, "required": [ "created_at", "created_by", "entries", "knowledge_base_id", "knowledge_base_query_id", "query" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | QueryKnowledgeBase 200 response | QueryKnowledgeBaseResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
SearchKnowledgeBase
POST /knowledge-bases/{knowledge_base_id}/search
Body parameter
{ "properties": { "query": { "type": "string" }, "query_args": {} }, "required": [ "query" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_id | path | string | true | none |
body | body | SearchKnowledgeBaseRequestContent | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_search_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "query": { "type": "string" }, "result": { "type": "string" } }, "required": [ "created_at", "created_by", "knowledge_base_id", "knowledge_base_search_id", "query", "result" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | SearchKnowledgeBase 200 response | SearchKnowledgeBaseResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListKnowledgeBaseSearches
GET /knowledge-bases/{knowledge_base_id}/searches
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
knowledge_base_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "knowledge_base_searches": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_search_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "query": { "type": "string" }, "result": { "type": "string" } }, "required": [ "created_at", "created_by", "knowledge_base_id", "knowledge_base_search_id", "query", "result" ], "type": "object" }, "type": "array" } }, "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListKnowledgeBaseSearches 200 response | ListKnowledgeBaseSearchesResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Libraries
ListLibraries
GET /libraries
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "libraries": { "items": { "properties": { "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "description": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "library_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_id", "created_at", "created_by", "data_connector_ids", "knowledge_base_ids", "library_id", "name", "organization_id", "retriever_id", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "libraries", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListLibraries 200 response | ListLibrariesResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateLibrary
POST /libraries
Body parameter
{ "properties": { "data_connector_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "description": { "maxLength": 256, "minLength": 1, "type": "string" }, "knowledge_base_configs": { "items": { "oneOf": [ { "properties": { "pg_vector": { "properties": { "connection_string": { "type": "string" }, "embedding_model": { "type": "string" }, "password": { "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "connection_string", "password" ], "type": "object" } }, "required": [ "pg_vector" ], "title": "pg_vector", "type": "object" }, { "properties": { "gtc_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "type": "object" } }, "required": [ "gtc_pg_vector" ], "title": "gtc_pg_vector", "type": "object" }, { "properties": { "gtc_hybrid_sql_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "structured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "description": { "type": "string" }, "sql_type": { "type": "string" } }, "required": [ "column_name", "description", "sql_type" ], "type": "object" }, "type": "array" }, "unstructured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "description": { "type": "string" } }, "required": [ "column_name", "description" ], "type": "object" }, "type": "array" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "structured_columns", "unstructured_columns" ], "type": "object" } }, "required": [ "gtc_hybrid_sql_pg_vector" ], "title": "gtc_hybrid_sql_pg_vector", "type": "object" }, { "properties": { "pgai_knowledge_base": { "type": "object" } }, "required": [ "pgai_knowledge_base" ], "title": "pgai_knowledge_base", "type": "object" } ] }, "type": "array" }, "name": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "data_connector_ids", "knowledge_base_configs", "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateLibraryRequestContent | true | none |
Example responses
201 Response
{ "properties": { "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "description": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "library_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_id", "created_at", "created_by", "data_connector_ids", "knowledge_base_ids", "library_id", "name", "organization_id", "retriever_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateLibrary 201 response | CreateLibraryResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteLibrary
DELETE /libraries/{library_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
library_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteLibrary 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetLibrary
GET /libraries/{library_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
library_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "description": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "library_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_id", "created_at", "created_by", "data_connector_ids", "knowledge_base_ids", "library_id", "name", "organization_id", "retriever_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetLibrary 200 response | GetLibraryResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateLibrary
PATCH /libraries/{library_id}
Body parameter
{ "properties": { "data_connector_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "description": { "maxLength": 256, "minLength": 1, "type": "string" }, "knowledge_base_configs": { "items": { "oneOf": [ { "properties": { "pg_vector": { "properties": { "connection_string": { "type": "string" }, "embedding_model": { "type": "string" }, "password": { "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "connection_string", "password" ], "type": "object" } }, "required": [ "pg_vector" ], "title": "pg_vector", "type": "object" }, { "properties": { "gtc_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "use_default_embedding_model": { "type": "boolean" } }, "type": "object" } }, "required": [ "gtc_pg_vector" ], "title": "gtc_pg_vector", "type": "object" }, { "properties": { "gtc_hybrid_sql_pg_vector": { "properties": { "embedding_model": { "type": "string" }, "structured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "description": { "type": "string" }, "sql_type": { "type": "string" } }, "required": [ "column_name", "description", "sql_type" ], "type": "object" }, "type": "array" }, "unstructured_columns": { "items": { "properties": { "column_name": { "type": "string" }, "description": { "type": "string" } }, "required": [ "column_name", "description" ], "type": "object" }, "type": "array" }, "use_default_embedding_model": { "type": "boolean" } }, "required": [ "structured_columns", "unstructured_columns" ], "type": "object" } }, "required": [ "gtc_hybrid_sql_pg_vector" ], "title": "gtc_hybrid_sql_pg_vector", "type": "object" }, { "properties": { "pgai_knowledge_base": { "type": "object" } }, "required": [ "pgai_knowledge_base" ], "title": "pgai_knowledge_base", "type": "object" } ] }, "type": "array" }, "name": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "data_connector_ids", "knowledge_base_configs", "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
library_id | path | string | true | none |
body | body | UpdateLibraryRequestContent | true | none |
Example responses
200 Response
{ "properties": { "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "description": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "library_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_id", "created_at", "created_by", "data_connector_ids", "knowledge_base_ids", "library_id", "name", "organization_id", "retriever_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateLibrary 200 response | UpdateLibraryResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Messages
DeleteMessage
DELETE /messages/{message_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
message_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteMessage 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetMessage
GET /messages/{message_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
message_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "index": { "type": "number" }, "input": { "type": "string" }, "message_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "output": { "type": "string" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "index", "input", "message_id", "metadata", "output", "thread_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetMessage 200 response | GetMessageResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateMessage
PATCH /messages/{message_id}
Body parameter
{ "properties": { "input": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "output": { "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
message_id | path | string | true | none |
body | body | UpdateMessageRequestContent | false | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "index": { "type": "number" }, "input": { "type": "string" }, "message_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "output": { "type": "string" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "index", "input", "message_id", "metadata", "output", "thread_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateMessage 200 response | UpdateMessageResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListMessages
GET /threads/{thread_id}/messages
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
thread_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "messages": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "index": { "type": "number" }, "input": { "type": "string" }, "message_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "output": { "type": "string" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "index", "input", "message_id", "metadata", "output", "thread_id", "updated_at" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "messages", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListMessages 200 response | ListMessagesResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateMessage
POST /threads/{thread_id}/messages
Body parameter
{ "properties": { "input": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "output": { "type": "string" } }, "required": [ "input", "output" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
thread_id | path | string | true | none |
body | body | CreateMessageRequestContent | true | none |
Example responses
201 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "index": { "type": "number" }, "input": { "type": "string" }, "message_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "output": { "type": "string" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "index", "input", "message_id", "metadata", "output", "thread_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateMessage 201 response | CreateMessageResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Models
ListModels
GET /models
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
model_type | query | string | false | none |
default | query | boolean | false | none |
Example responses
200 Response
{ "properties": { "models": { "items": { "properties": { "default": { "type": "boolean" }, "description": { "type": "string" }, "model_name": { "type": "string" }, "model_type": { "enum": [ "chat", "embedding", "rerank", "image_generation", "unknown" ], "type": "string" } }, "required": [ "default", "model_name", "model_type" ], "type": "object" }, "type": "array" }, "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" } }, "required": [ "models", "pagination" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListModels 200 response | ListModelsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Organizations
ListOrganizations
GET /organizations
Example responses
200 Response
{ "properties": { "organizations": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "default_bucket_id": { "type": "string" }, "description": { "maxLength": 2000, "type": "string" }, "entitlement": { "allOf": [ { "enum": [ "FREE", "PAID", "PARTNER", "UNPAID", "EXPIRED" ], "type": "string" }, { "default": "FREE" } ] }, "model_config": { "properties": { "default_chat_model": { "type": "string" }, "default_embedding_model": { "type": "string" }, "default_image_generation_model": { "type": "string" }, "default_rerank_model": { "type": "string" } }, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "default_bucket_id", "description", "entitlement", "name", "organization_id", "updated_at" ], "type": "object" }, "type": "array" } }, "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListOrganizations 200 response | ListOrganizationsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateOrganization
POST /organizations
Body parameter
{ "properties": { "description": { "maxLength": 2000, "minLength": 1, "type": "string" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateOrganizationRequestContent | true | none |
Example responses
201 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "default_bucket_id": { "type": "string" }, "description": { "maxLength": 2000, "type": "string" }, "entitlement": { "allOf": [ { "enum": [ "FREE", "PAID", "PARTNER", "UNPAID", "EXPIRED" ], "type": "string" }, { "default": "FREE" } ] }, "model_config": { "properties": { "default_chat_model": { "type": "string" }, "default_embedding_model": { "type": "string" }, "default_image_generation_model": { "type": "string" }, "default_rerank_model": { "type": "string" } }, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "default_bucket_id", "description", "entitlement", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateOrganization 201 response | CreateOrganizationResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteOrganization
DELETE /organizations/{organization_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
organization_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteOrganization 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetOrganization
GET /organizations/{organization_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
organization_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "default_bucket_id": { "type": "string" }, "description": { "maxLength": 2000, "type": "string" }, "entitlement": { "allOf": [ { "enum": [ "FREE", "PAID", "PARTNER", "UNPAID", "EXPIRED" ], "type": "string" }, { "default": "FREE" } ] }, "model_config": { "properties": { "default_chat_model": { "type": "string" }, "default_embedding_model": { "type": "string" }, "default_image_generation_model": { "type": "string" }, "default_rerank_model": { "type": "string" } }, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "default_bucket_id", "description", "entitlement", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetOrganization 200 response | GetOrganizationResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateOrganization
PATCH /organizations/{organization_id}
Body parameter
{ "properties": { "model_config": { "properties": { "default_chat_model": { "type": "string" }, "default_embedding_model": { "type": "string" }, "default_image_generation_model": { "type": "string" }, "default_rerank_model": { "type": "string" } }, "type": "object" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
organization_id | path | string | true | none |
body | body | UpdateOrganizationRequestContent | false | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "default_bucket_id": { "type": "string" }, "description": { "maxLength": 2000, "type": "string" }, "entitlement": { "allOf": [ { "enum": [ "FREE", "PAID", "PARTNER", "UNPAID", "EXPIRED" ], "type": "string" }, { "default": "FREE" } ] }, "model_config": { "properties": { "default_chat_model": { "type": "string" }, "default_embedding_model": { "type": "string" }, "default_image_generation_model": { "type": "string" }, "default_rerank_model": { "type": "string" } }, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "default_bucket_id", "description", "entitlement", "name", "organization_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateOrganization 200 response | UpdateOrganizationResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListOrganizationUsers
GET /organizations/{organization_id}/users
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
organization_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "users": { "items": { "properties": { "email": { "type": "string" }, "user_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "email", "user_id" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "users" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListOrganizationUsers 200 response | ListOrganizationUsersResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteOrganizationUser
DELETE /organizations/{organization_id}/users/{user_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
organization_id | path | string | true | none |
user_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteOrganizationUser 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
RetrieverComponents
ListRetrieverComponents
GET /retriever-components
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "retriever_components": { "items": { "properties": { "config": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_component_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "name", "organization_id", "retriever_component_id", "type", "updated_at" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "retriever_components" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListRetrieverComponents 200 response | ListRetrieverComponentsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateRetrieverComponent
POST /retriever-components
Body parameter
{ "properties": { "config": {}, "description": { "maxLength": 256, "minLength": 1, "type": "string" }, "name": { "maxLength": 64, "minLength": 1, "type": "string" }, "type": { "type": "string" } }, "required": [ "config", "name", "type" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateRetrieverComponentRequestContent | true | none |
Example responses
201 Response
{ "properties": { "config": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_component_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "name", "organization_id", "retriever_component_id", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateRetrieverComponent 201 response | CreateRetrieverComponentResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteRetrieverComponent
DELETE /retriever-components/{retriever_component_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
retriever_component_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteRetrieverComponent 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetRetrieverComponent
GET /retriever-components/{retriever_component_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
retriever_component_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "config": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_component_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "name", "organization_id", "retriever_component_id", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetRetrieverComponent 200 response | GetRetrieverComponentResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateRetrieverComponent
PATCH /retriever-components/{retriever_component_id}
Body parameter
{ "properties": { "config": {}, "description": { "maxLength": 256, "minLength": 1, "type": "string" }, "name": { "maxLength": 64, "minLength": 1, "type": "string" }, "type": { "type": "string" } }, "required": [ "config", "type" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
retriever_component_id | path | string | true | none |
body | body | UpdateRetrieverComponentRequestContent | true | none |
Example responses
200 Response
{ "properties": { "config": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_component_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "name", "organization_id", "retriever_component_id", "type", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateRetrieverComponent 200 response | UpdateRetrieverComponentResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Retrievers
ListRetrievers
GET /retrievers
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "retrievers": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_components": { "items": { "properties": { "config": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_component_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "name", "organization_id", "retriever_component_id", "type", "updated_at" ], "type": "object" }, "type": "array" }, "retriever_components_schema": {}, "retriever_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "name", "organization_id", "retriever_components", "retriever_components_schema", "retriever_id", "updated_at" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "retrievers" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListRetrievers 200 response | ListRetrieversResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateRetriever
POST /retrievers
Body parameter
{ "properties": { "description": { "maxLength": 256, "minLength": 1, "type": "string" }, "name": { "maxLength": 64, "minLength": 1, "type": "string" }, "retriever_component_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "retriever_components": { "items": { "properties": { "config": {}, "description": { "maxLength": 256, "minLength": 1, "type": "string" }, "name": { "maxLength": 64, "minLength": 1, "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ], "type": "object" }, "type": "array" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateRetrieverRequestContent | true | none |
Example responses
201 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_components": { "items": { "properties": { "config": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_component_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "name", "organization_id", "retriever_component_id", "type", "updated_at" ], "type": "object" }, "type": "array" }, "retriever_components_schema": {}, "retriever_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "name", "organization_id", "retriever_components", "retriever_components_schema", "retriever_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateRetriever 201 response | CreateRetrieverResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteRetriever
DELETE /retrievers/{retriever_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
retriever_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteRetriever 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetRetriever
GET /retrievers/{retriever_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
retriever_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_components": { "items": { "properties": { "config": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_component_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "name", "organization_id", "retriever_component_id", "type", "updated_at" ], "type": "object" }, "type": "array" }, "retriever_components_schema": {}, "retriever_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "name", "organization_id", "retriever_components", "retriever_components_schema", "retriever_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetRetriever 200 response | GetRetrieverResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateRetriever
PATCH /retrievers/{retriever_id}
Body parameter
{ "properties": { "description": { "maxLength": 256, "minLength": 1, "type": "string" }, "name": { "maxLength": 64, "minLength": 1, "type": "string" }, "retriever_component_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "retriever_components": { "items": { "properties": { "config": {}, "description": { "maxLength": 256, "minLength": 1, "type": "string" }, "name": { "maxLength": 64, "minLength": 1, "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ], "type": "object" }, "type": "array" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
retriever_id | path | string | true | none |
body | body | UpdateRetrieverRequestContent | false | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_components": { "items": { "properties": { "config": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_component_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "name", "organization_id", "retriever_component_id", "type", "updated_at" ], "type": "object" }, "type": "array" }, "retriever_components_schema": {}, "retriever_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "name", "organization_id", "retriever_components", "retriever_components_schema", "retriever_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateRetriever 200 response | UpdateRetrieverResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
QueryRetriever
POST /retrievers/{retriever_id}/query
Body parameter
{ "properties": { "query": { "type": "string" }, "retriever_components_query_args": {} }, "required": [ "query" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
retriever_id | path | string | true | none |
body | body | QueryRetrieverRequestContent | true | none |
Example responses
200 Response
{ "properties": { "outputs": { "items": {}, "type": "array" } }, "required": [ "outputs" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | QueryRetriever 200 response | QueryRetrieverResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Rules
ListRules
GET /rules
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
ruleset_id | query | string | false | none |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "rules": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "rule": { "type": "string" }, "rule_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "metadata", "name", "organization_id", "rule", "rule_id", "updated_at" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "rules" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListRules 200 response | ListRulesResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateRule
POST /rules
Body parameter
{ "properties": { "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "rule": { "maxLength": 2000, "minLength": 1, "type": "string" } }, "required": [ "name", "rule" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateRuleRequestContent | true | none |
Example responses
201 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "rule": { "type": "string" }, "rule_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "metadata", "name", "organization_id", "rule", "rule_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateRule 201 response | CreateRuleResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteRule
DELETE /rules/{rule_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
rule_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteRule 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetRule
GET /rules/{rule_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
rule_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "rule": { "type": "string" }, "rule_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "metadata", "name", "organization_id", "rule", "rule_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetRule 200 response | GetRuleResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateRule
PATCH /rules/{rule_id}
Body parameter
{ "properties": { "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "rule": { "maxLength": 2000, "minLength": 1, "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
rule_id | path | string | true | none |
body | body | UpdateRuleRequestContent | false | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "rule": { "type": "string" }, "rule_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "metadata", "name", "organization_id", "rule", "rule_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateRule 200 response | UpdateRuleResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Rulesets
ListRulesets
GET /rulesets
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
alias | query | string | false | none |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "rulesets": { "items": { "properties": { "alias": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "rule_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "alias", "created_at", "created_by", "description", "metadata", "name", "organization_id", "rule_ids", "ruleset_id", "updated_at" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "rulesets" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListRulesets 200 response | ListRulesetsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateRuleset
POST /rulesets
Body parameter
{ "properties": { "alias": { "maxLength": 200, "minLength": 1, "type": "string" }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "rule_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateRulesetRequestContent | true | none |
Example responses
201 Response
{ "properties": { "alias": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "rule_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "alias", "created_at", "created_by", "description", "metadata", "name", "organization_id", "rule_ids", "ruleset_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateRuleset 201 response | CreateRulesetResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteRuleset
DELETE /rulesets/{ruleset_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
ruleset_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteRuleset 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetRuleset
GET /rulesets/{ruleset_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
ruleset_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "alias": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "rule_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "alias", "created_at", "created_by", "description", "metadata", "name", "organization_id", "rule_ids", "ruleset_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetRuleset 200 response | GetRulesetResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateRuleset
PATCH /rulesets/{ruleset_id}
Body parameter
{ "properties": { "alias": { "maxLength": 200, "minLength": 1, "type": "string" }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "rule_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
ruleset_id | path | string | true | none |
body | body | UpdateRulesetRequestContent | false | none |
Example responses
200 Response
{ "properties": { "alias": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "rule_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "alias", "created_at", "created_by", "description", "metadata", "name", "organization_id", "rule_ids", "ruleset_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateRuleset 200 response | UpdateRulesetResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Secrets
ListSecrets
GET /secrets
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "secrets": { "items": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "secret_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "last_used", "name", "organization_id", "secret_id", "updated_at" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "secrets" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListSecrets 200 response | ListSecretsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateSecret
POST /secrets
Body parameter
{ "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "value": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "name", "value" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateSecretRequestContent | true | none |
Example responses
201 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "secret_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "last_used", "name", "organization_id", "secret_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateSecret 201 response | CreateSecretResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteSecret
DELETE /secrets/{secret_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
secret_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteSecret 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetSecret
GET /secrets/{secret_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
secret_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "secret_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "last_used", "name", "organization_id", "secret_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetSecret 200 response | GetSecretResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateSecret
PATCH /secrets/{secret_id}
Body parameter
{ "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "value": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
secret_id | path | string | true | none |
body | body | UpdateSecretRequestContent | false | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "secret_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "last_used", "name", "organization_id", "secret_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateSecret 200 response | UpdateSecretResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
StructureRuns
GetStructureRun
GET /structure-runs/{structure_run_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_run_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "output": {}, "output_timestamp": { "format": "double", "type": "number" }, "started_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "completed_at", "created_at", "created_by", "started_at", "status", "structure_id", "structure_run_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetStructureRun 200 response | GetStructureRunResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CancelStructureRun
POST /structure-runs/{structure_run_id}/cancel
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_run_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "output": {}, "output_timestamp": { "format": "double", "type": "number" }, "started_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "completed_at", "created_at", "created_by", "started_at", "status", "structure_id", "structure_run_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | CancelStructureRun 200 response | CancelStructureRunResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListStructureRunLogs
GET /structure-runs/{structure_run_id}/logs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_run_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "logs": { "items": { "type": "string" }, "type": "array" } }, "required": [ "logs" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListStructureRunLogs 200 response | ListStructureRunLogsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListStructureRuns
GET /structures/{structure_id}/runs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
status | query | array[string] | false | Comma-separated list of run statuses to filter by. |
Enumerated Values
Parameter | Value |
---|---|
status | QUEUED |
status | STARTING |
status | RUNNING |
status | SUCCEEDED |
status | FAILED |
status | ERROR |
status | CANCELLED |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "structure_runs": { "items": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "output": {}, "output_timestamp": { "format": "double", "type": "number" }, "started_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "completed_at", "created_at", "created_by", "started_at", "status", "structure_id", "structure_run_id", "updated_at" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "structure_runs" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListStructureRuns 200 response | ListStructureRunsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateStructureRun
POST /structures/{structure_id}/runs
Body parameter
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" } }, "required": [ "args" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_id | path | string | true | none |
body | body | CreateStructureRunRequestContent | true | none |
Example responses
201 Response
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "output": {}, "output_timestamp": { "format": "double", "type": "number" }, "started_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "completed_at", "created_at", "created_by", "started_at", "status", "structure_id", "structure_run_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateStructureRun 201 response | CreateStructureRunResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Spans
ListSpans
GET /structure-runs/{structure_run_id}/spans
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
structure_run_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "page": { "type": "number" }, "spans": { "items": { "properties": { "attributes": {}, "end_time": { "format": "date-time", "type": "string" }, "events": { "properties": { "attributes": {}, "name": { "type": "string" }, "timestamp": { "format": "date-time", "type": "string" } }, "required": [ "attributes", "name", "timestamp" ], "type": "object" }, "name": { "type": "string" }, "parent_id": { "type": "string" }, "span_id": { "type": "string" }, "start_time": { "format": "date-time", "type": "string" }, "status": { "enum": [ "UNSET", "OK", "ERROR" ], "type": "string" }, "trace_id": { "type": "string" } }, "required": [ "attributes", "end_time", "events", "name", "span_id", "start_time", "status", "trace_id" ], "type": "object" }, "type": "array" } }, "required": [ "spans" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListSpans 200 response | ListSpansResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Threads
ListThreads
GET /threads
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
alias | query | string | false | none |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "threads": { "items": { "properties": { "alias": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "alias", "created_at", "created_by", "metadata", "name", "organization_id", "thread_id", "updated_at" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "threads" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListThreads 200 response | ListThreadsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateThread
POST /threads
Body parameter
{ "properties": { "alias": { "maxLength": 200, "minLength": 1, "type": "string" }, "messages": { "items": { "properties": { "input": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "output": { "type": "string" } }, "required": [ "input", "output" ], "type": "object" }, "type": "array" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateThreadRequestContent | true | none |
Example responses
201 Response
{ "properties": { "alias": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "alias", "created_at", "created_by", "metadata", "name", "organization_id", "thread_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateThread 201 response | CreateThreadResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteThread
DELETE /threads/{thread_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
thread_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteThread 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetThread
GET /threads/{thread_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
thread_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "alias": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "alias", "created_at", "created_by", "metadata", "name", "organization_id", "thread_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetThread 200 response | GetThreadResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateThread
PATCH /threads/{thread_id}
Body parameter
{ "properties": { "alias": { "maxLength": 200, "minLength": 1, "type": "string" }, "messages": { "items": { "properties": { "input": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "output": { "type": "string" } }, "required": [ "input", "output" ], "type": "object" }, "type": "array" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
thread_id | path | string | true | none |
body | body | UpdateThreadRequestContent | false | none |
Example responses
200 Response
{ "properties": { "alias": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "metadata": { "additionalProperties": {}, "type": "object" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "alias", "created_at", "created_by", "metadata", "name", "organization_id", "thread_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateThread 200 response | UpdateThreadResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ToolRuns
GetToolRun
GET /tool-runs/{tool_run_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
tool_run_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "input": {}, "output": {}, "output_timestamp": { "format": "double", "type": "number" }, "runtime_path": { "type": "string" }, "started_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "tool_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "completed_at", "created_at", "created_by", "input", "runtime_path", "started_at", "status", "tool_id", "tool_run_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetToolRun 200 response | GetToolRunResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListToolRunLogs
GET /tool-runs/{tool_run_id}/logs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
tool_run_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "logs": { "items": { "type": "string" }, "type": "array" } }, "required": [ "logs" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListToolRunLogs 200 response | ListToolRunLogsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ListToolRuns
GET /tools/{tool_id}/runs
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
tool_id | path | string | true | none |
page | query | number | false | none |
page_size | query | number | false | none |
status | query | array[string] | false | Comma-separated list of run statuses to filter by. |
Enumerated Values
Parameter | Value |
---|---|
status | QUEUED |
status | STARTING |
status | RUNNING |
status | SUCCEEDED |
status | FAILED |
status | ERROR |
status | CANCELLED |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "tool_runs": { "items": { "properties": { "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "input": {}, "output": {}, "output_timestamp": { "format": "double", "type": "number" }, "runtime_path": { "type": "string" }, "started_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "tool_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "completed_at", "created_at", "created_by", "input", "runtime_path", "started_at", "status", "tool_id", "tool_run_id", "updated_at" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "tool_runs" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListToolRuns 200 response | ListToolRunsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Tools
ListTools
GET /tools
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | false | none |
page_size | query | number | false | none |
Example responses
200 Response
{ "properties": { "pagination": { "properties": { "next_page": { "type": "number" }, "page_number": { "type": "number" }, "page_size": { "type": "number" }, "previous_page": { "type": "number" }, "total_count": { "type": "number" }, "total_pages": { "type": "number" } }, "required": [ "page_number", "page_size", "total_count", "total_pages" ], "type": "object" }, "tools": { "items": { "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_config_file": { "type": "string" }, "tool_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "latest_deployment_id", "name", "organization_id", "tool_id", "updated_at" ], "type": "object" }, "type": "array" } }, "required": [ "pagination", "tools" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | ListTools 200 response | ListToolsResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
CreateTool
POST /tools
Body parameter
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "tool_config_file": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateToolRequestContent | true | none |
Example responses
201 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_config_file": { "type": "string" }, "tool_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "latest_deployment_id", "name", "organization_id", "tool_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
201 | Created | CreateTool 201 response | CreateToolResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
DeleteTool
DELETE /tools/{tool_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
tool_id | path | string | true | none |
Example responses
400 Response
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
204 | No Content | DeleteTool 204 response | None |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetTool
GET /tools/{tool_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
tool_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_config_file": { "type": "string" }, "tool_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "latest_deployment_id", "name", "organization_id", "tool_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetTool 200 response | GetToolResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
UpdateTool
PATCH /tools/{tool_id}
Body parameter
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "tool_config_file": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" }
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
tool_id | path | string | true | none |
body | body | UpdateToolRequestContent | false | none |
Example responses
200 Response
{ "properties": { "code": { "oneOf": [ { "properties": { "github": { "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "owner": { "maxLength": 200, "minLength": 1, "type": "string" }, "push": { "properties": { "branch": { "maxLength": 200, "minLength": 1, "type": "string" }, "tag": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "branch" ], "type": "object" } }, "required": [ "name", "owner", "push" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" }, { "properties": { "default": { "type": "object" } }, "required": [ "default" ], "title": "default", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "latest_deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_config_file": { "type": "string" }, "tool_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "code", "created_at", "created_by", "description", "env_vars", "latest_deployment_id", "name", "organization_id", "tool_id", "updated_at" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | UpdateTool 200 response | UpdateToolResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
ToolInvoke
CreateToolActivityRun
POST /tools/{tool_id}/activities/{activity_path}
Body parameter
{}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
tool_id | path | string | true | none |
activity_path | path | string | true | none |
body | body | CreateToolActivityRunInputPayload | false | none |
Example responses
200 Response
{}
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | CreateToolActivityRun 200 response | CreateToolActivityRunOutputPayload |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
GetToolOpenApiRun
GET /tools/{tool_id}/openapi
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
tool_id | path | string | true | none |
Example responses
200 Response
{}
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetToolOpenApiRun 200 response | GetToolOpenApiRunOutputPayload |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Usage
GetUsage
GET /usage
Example responses
200 Response
{ "properties": { "bytes_ingested": { "type": "number" }, "bytes_ingested_limit": { "type": "number" }, "rag_queries": { "type": "number" }, "rag_queries_limit": { "type": "number" }, "runtime_seconds": { "type": "number" }, "runtime_seconds_limit": { "type": "number" }, "usage_period_end": { "format": "date-time", "type": "string" }, "usage_period_start": { "format": "date-time", "type": "string" } }, "required": [ "bytes_ingested", "bytes_ingested_limit", "rag_queries", "rag_queries_limit", "runtime_seconds", "runtime_seconds_limit", "usage_period_end", "usage_period_start" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetUsage 200 response | GetUsageResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Users
GetUser
GET /users/{user_id}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
user_id | path | string | true | none |
Example responses
200 Response
{ "properties": { "created_at": { "format": "date-time", "type": "string" }, "email": { "type": "string" }, "name": { "type": "string" }, "organizations": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" }, "user_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "created_at", "email", "organizations", "updated_at", "user_id" ], "type": "object" }
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | GetUser 200 response | GetUserResponseContent |
400 | Bad Request | ClientError 400 response | ClientErrorResponseContent |
500 | Internal Server Error | ServiceError 500 response | ServiceErrorResponseContent |
Warning
To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth
Schemas
ActivityDuration
{ "properties": { "activity_type": { "type": "string" }, "seconds": { "type": "number" } }, "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
activity_type | string | false | none | none |
seconds | number | false | none | none |
ApiKeyDetail
{ "properties": { "active": { "type": "boolean" }, "api_key_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "active", "api_key_id", "created_at", "created_by", "last_used", "name", "organization_id", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
active | boolean | true | none | none |
api_key_id | string | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
last_used | string(date-time) | true | none | none |
name | string | true | none | none |
organization_id | string | true | none | none |
updated_at | string(date-time) | true | none | none |
Artifact
{ "properties": { "id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "meta": {}, "name": { "type": "string" }, "reference": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "name", "type", "value" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | string | true | none | none |
meta | any | false | none | none |
name | string | true | none | none |
reference | string | false | none | none |
type | string | true | none | none |
value | string | true | none | none |
AssertUrlOperation
{ "enum": [ "PUT", "GET" ], "type": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | string | false | none | none |
Enumerated Values
Property | Value |
---|---|
anonymous | PUT |
anonymous | GET |
AssetDetail
{ "properties": { "bucket_id": { "type": "string" }, "contents": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "size": { "type": "number" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
bucket_id | string | false | none | none |
contents | any | false | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
name | string | true | none | none |
organization_id | string | true | none | none |
size | number | false | none | none |
updated_at | string(date-time) | true | none | none |
AssistantDetail
{ "properties": { "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_id", "created_at", "created_by", "description", "knowledge_base_ids", "name", "organization_id", "retriever_ids", "ruleset_ids", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
assistant_id | string | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
description | string | true | none | none |
input | string | false | none | none |
knowledge_base_ids | [string] | true | none | none |
name | string | true | none | none |
organization_id | string | true | none | none |
retriever_ids | [string] | true | none | none |
ruleset_ids | [string] | true | none | none |
structure_ids | [string] | true | none | none |
tool_ids | [string] | true | none | none |
updated_at | string(date-time) | true | none | none |
AssistantEventDetail
{ "properties": { "assistant_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "event_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "origin": { "type": "string" }, "payload": {}, "timestamp": { "format": "double", "type": "number" }, "type": { "type": "string" } }, "required": [ "assistant_run_id", "created_at", "event_id", "origin", "payload", "timestamp", "type" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
assistant_run_id | string | true | none | none |
created_at | string(date-time) | true | none | none |
event_id | string | true | none | none |
origin | string | true | none | none |
payload | any | true | none | none |
timestamp | number(double) | true | none | none |
type | string | true | none | none |
AssistantRunDetail
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "assistant_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "output": {}, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "stream": { "type": "boolean" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "assistant_id", "assistant_run_id", "completed_at", "created_at", "created_by", "knowledge_base_ids", "retriever_ids", "ruleset_ids", "status", "stream", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
args | [string] | true | none | none |
assistant_id | string | true | none | none |
assistant_run_id | string | true | none | none |
completed_at | string(date-time)¦null | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
input | string | false | none | none |
knowledge_base_ids | [string] | true | none | none |
output | any | false | none | none |
retriever_ids | [string] | true | none | none |
ruleset_ids | [string] | true | none | none |
status | AssistantRunStatus | true | none | none |
status_detail | any | false | none | none |
stream | boolean | true | none | none |
structure_ids | [string] | true | none | none |
thread_id | string | false | none | none |
tool_ids | [string] | true | none | none |
updated_at | string(date-time) | true | none | none |
AssistantRunStatus
{ "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | string | false | none | none |
Enumerated Values
Property | Value |
---|---|
anonymous | QUEUED |
anonymous | STARTING |
anonymous | RUNNING |
anonymous | SUCCEEDED |
anonymous | FAILED |
anonymous | ERROR |
anonymous | CANCELLED |
BucketDetail
{ "properties": { "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "bucket_id", "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
bucket_id | string | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
name | string | true | none | none |
organization_id | string | true | none | none |
updated_at | string(date-time) | true | none | none |
CancelAssistantRunResponseContent
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "assistant_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "output": {}, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "stream": { "type": "boolean" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "assistant_id", "assistant_run_id", "completed_at", "created_at", "created_by", "knowledge_base_ids", "retriever_ids", "ruleset_ids", "status", "stream", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
args | [string] | true | none | none |
assistant_id | string | true | none | none |
assistant_run_id | string | true | none | none |
completed_at | string(date-time)¦null | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
input | string | false | none | none |
knowledge_base_ids | [string] | true | none | none |
output | any | false | none | none |
retriever_ids | [string] | true | none | none |
ruleset_ids | [string] | true | none | none |
status | AssistantRunStatus | true | none | none |
status_detail | any | false | none | none |
stream | boolean | true | none | none |
structure_ids | [string] | true | none | none |
thread_id | string | false | none | none |
tool_ids | [string] | true | none | none |
updated_at | string(date-time) | true | none | none |
CancelDataJobResponseContent
{ "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "data_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "data_connector_id", "data_job_id", "status" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
bytes_ingested | number | false | none | none |
completed_at | string(date-time)¦null | false | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
data_connector_id | string | true | none | none |
data_job_id | string | true | none | none |
errors | [Error] | false | none | none |
status | DataJobStatus | true | none | none |
status_detail | any | false | none | none |
CancelKnowledgeBaseJobResponseContent
{ "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "knowledge_base_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "knowledge_base_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "knowledge_base_id", "knowledge_base_job_id", "status" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
bytes_ingested | number | false | none | none |
completed_at | string(date-time)¦null | false | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
errors | [Error] | false | none | none |
knowledge_base_id | string | true | none | none |
knowledge_base_job_id | string | true | none | none |
status | KnowledgeBaseJobStatus | true | none | none |
status_detail | any | false | none | none |
CancelStructureRunResponseContent
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "env_vars": { "items": { "properties": { "name": { "type": "string" }, "source": { "enum": [ "secret_ref", "manual" ], "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "output": {}, "output_timestamp": { "format": "double", "type": "number" }, "started_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "structure_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "structure_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "completed_at", "created_at", "created_by", "started_at", "status", "structure_id", "structure_run_id", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
args | [string] | true | none | none |
completed_at | string(date-time)¦null | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
deployment_id | string | false | none | none |
env_vars | [EnvVar] | false | none | none |
output | any | false | none | none |
output_timestamp | number(double) | false | none | none |
started_at | string(date-time)¦null | true | none | none |
status | StructureRunStatus | true | none | none |
status_detail | any | false | none | none |
structure_id | string | true | none | none |
structure_run_id | string | true | none | none |
updated_at | string(date-time) | true | none | none |
ChatMessageDriverConfiguration
{ "properties": { "extra_params": {}, "max_tokens": { "type": "number" }, "model": { "type": "string" }, "structured_output_strategy": { "type": "string" }, "temperature": { "format": "float", "type": "number" }, "use_native_tools": { "type": "boolean" } }, "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
extra_params | any | false | none | none |
max_tokens | number | false | none | none |
model | string | false | none | none |
structured_output_strategy | string | false | none | none |
temperature | number(float) | false | none | none |
use_native_tools | boolean | false | none | none |
ChatMessageMessage
{ "properties": { "content": { "items": { "properties": { "artifact": { "properties": { "id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "meta": {}, "name": { "type": "string" }, "reference": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "name", "type", "value" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "artifact", "type" ], "type": "object" }, "type": "array" }, "role": { "type": "string" }, "usage": { "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "type": { "type": "string" } }, "required": [ "input_tokens", "output_tokens", "type" ], "type": "object" } }, "required": [ "content", "role", "usage" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
content | [MessageContent] | true | none | none |
role | string | true | none | none |
usage | ChatMessageUsage | true | none | none |
ChatMessageTool
{ "properties": { "activities": { "items": { "properties": { "description": { "type": "string" }, "json_schema": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "id": { "type": "string" }, "properties": { "properties": { "member": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "properties": "[Circular]", "required": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "properties", "required", "type" ], "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "schema": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "id", "properties", "required", "schema", "title", "type" ], "type": "object" }, "name": { "type": "string" } }, "required": [ "description", "json_schema", "name" ], "type": "object" }, "type": "array" }, "name": { "type": "string" } }, "required": [ "activities", "name" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
activities | [ChatMessageToolActivity] | true | none | none |
name | string | true | none | none |
ChatMessageToolActivity
{ "properties": { "description": { "type": "string" }, "json_schema": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "id": { "type": "string" }, "properties": { "properties": { "member": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "properties": "[Circular]", "required": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "properties", "required", "type" ], "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "schema": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "id", "properties", "required", "schema", "title", "type" ], "type": "object" }, "name": { "type": "string" } }, "required": [ "description", "json_schema", "name" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
description | string | true | none | none |
json_schema | JsonSchema | true | none | none |
name | string | true | none | none |
ChatMessageUsage
{ "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "type": { "type": "string" } }, "required": [ "input_tokens", "output_tokens", "type" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
input_tokens | number | true | none | none |
output_tokens | number | true | none | none |
type | string | true | none | none |
ClientErrorResponseContent
{ "properties": { "errors": { "items": {}, "type": "array" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
errors | [any] | false | none | none |
type | string | true | none | none |
CodeSource
{ "oneOf": [ { "properties": { "github": { "properties": { "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }
Properties
oneOf
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | object | false | none | none |
» github | GithubCodeSource | true | none | none |
xor
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | object | false | none | none |
» data_lake | DataLakeCodeSource | true | none | none |
CodeSourceInput
{ "oneOf": [ { "properties": { "github": { "properties": { "access_token": { "maxLength": 1000, "minLength": 1, "type": "string" }, "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" } ] }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
github | GithubCodeSourceInput | true | none | none |
ConfluenceDetail
{ "properties": { "atlassian_email": { "type": "string" }, "domain": { "type": "string" } }, "required": [ "atlassian_email", "domain" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
atlassian_email | string | true | none | none |
domain | string | true | none | none |
ConfluenceInput
{ "properties": { "atlassian_api_token": { "type": "string" }, "atlassian_email": { "type": "string" }, "domain": { "type": "string" } }, "required": [ "atlassian_api_token", "atlassian_email", "domain" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
atlassian_api_token | string | true | none | none |
atlassian_email | string | true | none | none |
domain | string | true | none | none |
ConnectionCredentialsInput
{ "oneOf": [ { "properties": { "github": { "properties": { "auth_code": { "type": "string" } }, "required": [ "auth_code" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" } ] }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
github | GitHubCredentialsInput | true | none | none |
ConnectionDetail
{ "properties": { "connection_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "connection_id", "created_at", "created_by", "name", "type", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
connection_id | string | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
name | string | true | none | none |
type | string | true | none | none |
updated_at | string(date-time) | true | none | none |
CreateApiKeyRequestContent
{ "properties": { "name": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
name | string | true | none | none |
CreateApiKeyResponseContent
{ "properties": { "active": { "type": "boolean" }, "api_key_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "last_used": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "value": { "type": "string" } }, "required": [ "active", "api_key_id", "created_at", "created_by", "last_used", "name", "organization_id", "updated_at", "value" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
active | boolean | true | none | none |
api_key_id | string | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
last_used | string(date-time) | true | none | none |
name | string | true | none | none |
organization_id | string | true | none | none |
updated_at | string(date-time) | true | none | none |
value | string | true | none | none |
CreateAssetRequestContent
{ "properties": { "name": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
name | string | true | none | none |
CreateAssetResponseContent
{ "properties": { "bucket_id": { "type": "string" }, "contents": {}, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "size": { "type": "number" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
bucket_id | string | false | none | none |
contents | any | false | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
name | string | true | none | none |
organization_id | string | true | none | none |
size | number | false | none | none |
updated_at | string(date-time) | true | none | none |
CreateAssetUrlRequestContent
{ "properties": { "operation": { "enum": [ "PUT", "GET" ], "type": "string" } }, "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
operation | AssertUrlOperation | false | none | none |
CreateAssetUrlResponseContent
{ "properties": { "headers": { "additionalProperties": {}, "type": "object" }, "url": { "type": "string" } }, "required": [ "headers", "url" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
headers | Metadata | true | none | none |
url | string | true | none | none |
CreateAssistantRequestContent
{ "properties": { "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" } }, "required": [ "name" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
description | string | false | none | none |
input | string | false | none | none |
knowledge_base_ids | [string] | false | none | none |
name | string | true | none | none |
retriever_ids | [string] | false | none | none |
ruleset_ids | [string] | false | none | none |
structure_ids | [string] | false | none | none |
tool_ids | [string] | false | none | none |
CreateAssistantResponseContent
{ "properties": { "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "description": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "assistant_id", "created_at", "created_by", "description", "knowledge_base_ids", "name", "organization_id", "retriever_ids", "ruleset_ids", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
assistant_id | string | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
description | string | true | none | none |
input | string | false | none | none |
knowledge_base_ids | [string] | true | none | none |
name | string | true | none | none |
organization_id | string | true | none | none |
retriever_ids | [string] | true | none | none |
ruleset_ids | [string] | true | none | none |
structure_ids | [string] | true | none | none |
tool_ids | [string] | true | none | none |
updated_at | string(date-time) | true | none | none |
CreateAssistantRunRequestContent
{ "properties": { "additional_knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "additional_retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "additional_ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "additional_structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "additional_tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "args": { "items": { "type": "string" }, "type": "array" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "new_thread": { "description": "If true, create a new thread for this run to be returned in the response thread_id.", "type": "boolean" }, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "stream": { "type": "boolean" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "thread_id": { "description": "If provided, the run will be associated with the given thread. This takes precedence over new_thread.", "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" } }, "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
additional_knowledge_base_ids | [string] | false | none | none |
additional_retriever_ids | [string] | false | none | none |
additional_ruleset_ids | [string] | false | none | none |
additional_structure_ids | [string] | false | none | none |
additional_tool_ids | [string] | false | none | none |
args | [string] | false | none | none |
input | string | false | none | none |
knowledge_base_ids | [string] | false | none | none |
new_thread | boolean | false | none | If true, create a new thread for this run to be returned in the response thread_id. |
retriever_ids | [string] | false | none | none |
ruleset_ids | [string] | false | none | none |
stream | boolean | false | none | none |
structure_ids | [string] | false | none | none |
thread_id | string | false | none | If provided, the run will be associated with the given thread. This takes precedence over new_thread. |
tool_ids | [string] | false | none | none |
CreateAssistantRunResponseContent
{ "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "assistant_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "assistant_run_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "input": { "type": "string" }, "knowledge_base_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "output": {}, "retriever_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "ruleset_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "status": { "enum": [ "QUEUED", "STARTING", "RUNNING", "SUCCEEDED", "FAILED", "ERROR", "CANCELLED" ], "type": "string" }, "status_detail": {}, "stream": { "type": "boolean" }, "structure_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "thread_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "tool_ids": { "items": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "args", "assistant_id", "assistant_run_id", "completed_at", "created_at", "created_by", "knowledge_base_ids", "retriever_ids", "ruleset_ids", "status", "stream", "structure_ids", "tool_ids", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
args | [string] | true | none | none |
assistant_id | string | true | none | none |
assistant_run_id | string | true | none | none |
completed_at | string(date-time)¦null | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
input | string | false | none | none |
knowledge_base_ids | [string] | true | none | none |
output | any | false | none | none |
retriever_ids | [string] | true | none | none |
ruleset_ids | [string] | true | none | none |
status | AssistantRunStatus | true | none | none |
status_detail | any | false | none | none |
stream | boolean | true | none | none |
structure_ids | [string] | true | none | none |
thread_id | string | false | none | none |
tool_ids | [string] | true | none | none |
updated_at | string(date-time) | true | none | none |
CreateBillingManagementUrlResponseContent
{ "properties": { "billing_management_url": { "type": "string" } }, "required": [ "billing_management_url" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
billing_management_url | string | true | none | none |
CreateBucketRequestContent
{ "properties": { "name": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
name | string | true | none | none |
CreateBucketResponseContent
{ "properties": { "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "bucket_id", "created_at", "created_by", "name", "organization_id", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
bucket_id | string | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
name | string | true | none | none |
organization_id | string | true | none | none |
updated_at | string(date-time) | true | none | none |
CreateChatMessageRequestContent
{ "properties": { "driver_configuration": { "properties": { "extra_params": {}, "max_tokens": { "type": "number" }, "model": { "type": "string" }, "structured_output_strategy": { "type": "string" }, "temperature": { "format": "float", "type": "number" }, "use_native_tools": { "type": "boolean" } }, "type": "object" }, "messages": { "items": { "properties": { "content": { "items": { "properties": { "artifact": { "properties": { "id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "meta": {}, "name": { "type": "string" }, "reference": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "name", "type", "value" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "artifact", "type" ], "type": "object" }, "type": "array" }, "role": { "type": "string" }, "usage": { "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "type": { "type": "string" } }, "required": [ "input_tokens", "output_tokens", "type" ], "type": "object" } }, "required": [ "content", "role", "usage" ], "type": "object" }, "type": "array" }, "output_schema": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "id": { "type": "string" }, "properties": { "properties": { "member": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "properties": "[Circular]", "required": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "properties", "required", "type" ], "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "schema": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "id", "properties", "required", "schema", "title", "type" ], "type": "object" }, "tools": { "items": { "properties": { "activities": { "items": { "properties": { "description": { "type": "string" }, "json_schema": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "id": { "type": "string" }, "properties": { "properties": { "member": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "properties": "[Circular]", "required": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "properties", "required", "type" ], "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "schema": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "id", "properties", "required", "schema", "title", "type" ], "type": "object" }, "name": { "type": "string" } }, "required": [ "description", "json_schema", "name" ], "type": "object" }, "type": "array" }, "name": { "type": "string" } }, "required": [ "activities", "name" ], "type": "object" }, "type": "array" } }, "required": [ "driver_configuration", "messages", "output_schema", "tools" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
driver_configuration | ChatMessageDriverConfiguration | true | none | none |
messages | [ChatMessageMessage] | true | none | none |
output_schema | JsonSchema | true | none | none |
tools | [ChatMessageTool] | true | none | none |
CreateChatMessageResponseContent
{ "properties": { "content": { "items": { "properties": { "artifact": { "properties": { "id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "meta": {}, "name": { "type": "string" }, "reference": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "name", "type", "value" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "artifact", "type" ], "type": "object" }, "type": "array" }, "role": { "type": "string" }, "type": { "type": "string" }, "usage": { "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "type": { "type": "string" } }, "required": [ "input_tokens", "output_tokens", "type" ], "type": "object" } }, "required": [ "content", "role", "type", "usage" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
content | [MessageContent] | true | none | none |
role | string | true | none | none |
type | string | true | none | none |
usage | ChatMessageUsage | true | none | none |
CreateChatMessageStreamRequestContent
{ "properties": { "driver_configuration": { "properties": { "extra_params": {}, "max_tokens": { "type": "number" }, "model": { "type": "string" }, "structured_output_strategy": { "type": "string" }, "temperature": { "format": "float", "type": "number" }, "use_native_tools": { "type": "boolean" } }, "type": "object" }, "messages": { "items": { "properties": { "content": { "items": { "properties": { "artifact": { "properties": { "id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "meta": {}, "name": { "type": "string" }, "reference": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "name", "type", "value" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "artifact", "type" ], "type": "object" }, "type": "array" }, "role": { "type": "string" }, "usage": { "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "type": { "type": "string" } }, "required": [ "input_tokens", "output_tokens", "type" ], "type": "object" } }, "required": [ "content", "role", "usage" ], "type": "object" }, "type": "array" }, "output_schema": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "id": { "type": "string" }, "properties": { "properties": { "member": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "properties": "[Circular]", "required": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "properties", "required", "type" ], "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "schema": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "id", "properties", "required", "schema", "title", "type" ], "type": "object" }, "tools": { "items": { "properties": { "activities": { "items": { "properties": { "description": { "type": "string" }, "json_schema": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "id": { "type": "string" }, "properties": { "properties": { "member": { "properties": { "additionalProperties": { "type": "boolean" }, "description": { "type": "string" }, "properties": "[Circular]", "required": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "properties", "required", "type" ], "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "schema": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "additionalProperties", "description", "id", "properties", "required", "schema", "title", "type" ], "type": "object" }, "name": { "type": "string" } }, "required": [ "description", "json_schema", "name" ], "type": "object" }, "type": "array" }, "name": { "type": "string" } }, "required": [ "activities", "name" ], "type": "object" }, "type": "array" } }, "required": [ "driver_configuration", "messages", "output_schema", "tools" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
driver_configuration | ChatMessageDriverConfiguration | true | none | none |
messages | [ChatMessageMessage] | true | none | none |
output_schema | JsonSchema | true | none | none |
tools | [ChatMessageTool] | true | none | none |
CreateChatMessageStreamResponseContent
{ "properties": { "content": { "items": { "properties": { "artifact": { "properties": { "id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "meta": {}, "name": { "type": "string" }, "reference": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "name", "type", "value" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "artifact", "type" ], "type": "object" }, "type": "array" }, "role": { "type": "string" }, "type": { "type": "string" }, "usage": { "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "type": { "type": "string" } }, "required": [ "input_tokens", "output_tokens", "type" ], "type": "object" } }, "required": [ "content", "role", "type" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
content | [StreamMessageContent] | true | none | none |
role | string | true | none | none |
type | string | true | none | none |
usage | ChatMessageUsage | false | none | none |
CreateCheckoutSessionRequestContent
{ "properties": { "price_lookup_key": { "type": "string" } }, "required": [ "price_lookup_key" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
price_lookup_key | string | true | none | none |
CreateCheckoutSessionResponseContent
{ "properties": { "redirect_url": { "type": "string" } }, "required": [ "redirect_url" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
redirect_url | string | true | none | none |
CreateConnectionRequestContent
{ "properties": { "credentials": { "oneOf": [ { "properties": { "github": { "properties": { "auth_code": { "type": "string" } }, "required": [ "auth_code" ], "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" } ] }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "credentials", "type" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
credentials | ConnectionCredentialsInput | true | none | none |
name | string | false | none | none |
type | string | true | none | none |
CreateConnectionResponseContent
{ "properties": { "connection_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" } }, "required": [ "connection_id", "created_at", "created_by", "name", "type" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
connection_id | string | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
name | string | true | none | none |
type | string | true | none | none |
CreateDataConnectorRequestContent
{ "properties": { "config": { "oneOf": [ { "properties": { "confluence": { "properties": { "atlassian_api_token": { "type": "string" }, "atlassian_email": { "type": "string" }, "domain": { "type": "string" } }, "required": [ "atlassian_api_token", "atlassian_email", "domain" ], "type": "object" } }, "required": [ "confluence" ], "title": "confluence", "type": "object" }, { "properties": { "google_drive": { "properties": { "auth_code": { "type": "string" }, "file_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "auth_code", "file_ids" ], "type": "object" } }, "required": [ "google_drive" ], "title": "google_drive", "type": "object" }, { "properties": { "webscraper": { "properties": { "urls": { "items": { "type": "string" }, "type": "array" } }, "required": [ "urls" ], "type": "object" } }, "required": [ "webscraper" ], "title": "webscraper", "type": "object" }, { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "required": [ "structure" ], "title": "structure", "type": "object" }, { "properties": { "s3": { "properties": { "aws_access_key_id": { "type": "string" }, "aws_secret_access_key": { "type": "string" }, "uris": { "items": { "type": "string" }, "type": "array" } }, "required": [ "aws_access_key_id", "aws_secret_access_key", "uris" ], "type": "object" } }, "required": [ "s3" ], "title": "s3", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "bucket_id": { "type": "string" } }, "required": [ "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "description": { "maxLength": 200, "minLength": 1, "type": "string" }, "name": { "maxLength": 200, "minLength": 1, "type": "string" }, "schedule_expression": { "maxLength": 200, "minLength": 1, "type": "string" }, "transforms": { "items": { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "required": [ "structure" ], "type": "object" }, "type": "array" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "config", "name", "type" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
config | DataConnectorConfigInputUnion | true | none | none |
description | string | false | none | none |
name | string | true | none | none |
schedule_expression | string | false | none | none |
transforms | [TransformInput] | false | none | none |
type | string | true | none | none |
CreateDataConnectorResponseContent
{ "properties": { "config": { "oneOf": [ { "properties": { "confluence": { "properties": { "atlassian_email": { "type": "string" }, "domain": { "type": "string" } }, "required": [ "atlassian_email", "domain" ], "type": "object" } }, "required": [ "confluence" ], "title": "confluence", "type": "object" }, { "properties": { "google_drive": { "properties": { "access_token": { "type": "string" }, "file_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "access_token", "file_ids" ], "type": "object" } }, "required": [ "google_drive" ], "title": "google_drive", "type": "object" }, { "properties": { "webscraper": { "properties": { "urls": { "items": { "type": "string" }, "type": "array" } }, "required": [ "urls" ], "type": "object" } }, "required": [ "webscraper" ], "title": "webscraper", "type": "object" }, { "properties": { "structure": { "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "structure_id": { "type": "string" } }, "required": [ "structure_id" ], "type": "object" } }, "required": [ "structure" ], "title": "structure", "type": "object" }, { "properties": { "s3": { "properties": { "aws_access_key_id": { "type": "string" }, "uris": { "items": { "type": "string" }, "type": "array" } }, "required": [ "aws_access_key_id", "uris" ], "type": "object" } }, "required": [ "s3" ], "title": "s3", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_paths": { "items": { "type": "string" }, "type": "array" }, "bucket_id": { "type": "string" } }, "required": [ "asset_paths", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "data_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" }, "schedule_expression": { "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "config", "created_at", "created_by", "data_connector_id", "name", "type", "updated_at" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
config | DataConnectorConfigUnion | true | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
data_connector_id | string | true | none | none |
data_job_id | string | false | none | none |
description | string | false | none | none |
name | string | true | none | none |
schedule_expression | string | false | none | none |
type | string | true | none | none |
updated_at | string(date-time) | true | none | none |
CreateDataJobResponseContent
{ "properties": { "bytes_ingested": { "type": "number" }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "data_connector_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "data_job_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "errors": { "items": { "properties": { "message": { "type": "string" }, "path": { "type": "string" }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" }, "type": "array" }, "status": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "type": "string" }, "status_detail": {} }, "required": [ "created_at", "created_by", "data_connector_id", "data_job_id", "status" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
bytes_ingested | number | false | none | none |
completed_at | string(date-time)¦null | false | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
data_connector_id | string | true | none | none |
data_job_id | string | true | none | none |
errors | [Error] | false | none | none |
status | DataJobStatus | true | none | none |
status_detail | any | false | none | none |
CreateEventsRequestContent
{ "properties": { "events": { "items": { "properties": { "payload": {}, "timestamp": { "format": "double", "type": "number" }, "type": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "timestamp", "type" ], "type": "object" }, "type": "array" } }, "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
events | [EventInput] | false | none | none |
CreateFunctionDeploymentRequestContent
{ "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "access_token": { "maxLength": 1000, "minLength": 1, "type": "string" }, "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" } ] }, "force": { "type": "boolean" } }, "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
code_source | CodeSourceInput | false | none | none |
force | boolean | false | none | none |
CreateFunctionDeploymentResponseContent
{ "properties": { "code_source": { "oneOf": [ { "properties": { "github": { "properties": { "commit_sha": { "maxLength": 200, "minLength": 1, "type": "string" } }, "type": "object" } }, "required": [ "github" ], "title": "github", "type": "object" }, { "properties": { "data_lake": { "properties": { "asset_path": { "type": "string" }, "bucket_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" } }, "required": [ "asset_path", "bucket_id" ], "type": "object" } }, "required": [ "data_lake" ], "title": "data_lake", "type": "object" } ] }, "completed_at": { "default": null, "format": "date-time", "type": "string", "nullable": true }, "created_at": { "format": "date-time", "type": "string" }, "created_by": { "type": "string" }, "deployment_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "function_id": { "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$", "type": "string" }, "status": { "enum": [ "QUEUED", "DEPLOYING", "SUCCEEDED", "FAILED", "ERROR" ], "type": "string" }, "status_detail": {} }, "required": [ "code_source", "created_at", "created_by", "deployment_id", "function_id", "status" ], "type": "object" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
code_source | CodeSource | true | none | none |
completed_at | string(date-time)¦null | false | none | none |
created_at | string(date-time) | true | none | none |
created_by | string | true | none | none |
deployment_id | string | true | none | none |
function_id | string | true | none | none |
status | DeploymentStatus | true | none | none |
status_detail | any | false | none | none |
CreateFunctionExecutionGetOutputPayload
{}
Properties
None