Gen AI Builder v2023-09-19 v1.3
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