Gen AI Builder v2023-09-19

Scroll down for example requests and responses.

Base URLs:

Authentication

  • HTTP Authentication, scheme: Bearer HTTP Bearer authentication

Default

ListUsers

GET /users

Example responses

200 Response
{
  "properties": {
    "users": {
      "items": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organizations": {
            "items": {
              "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
              "type": "string"
            },
            "type": "array"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "user_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          }
        },
        "required": [
          "created_at",
          "email",
          "organizations",
          "updated_at",
          "user_id"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListUsers 200 responseListUsersResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
api_key_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteApiKey 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
api_key_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetApiKey 200 responseGetApiKeyResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
api_key_idpathstringtruenone
bodybodyUpdateApiKeyRequestContentfalsenone

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

StatusMeaningDescriptionSchema
200OKUpdateApiKey 200 responseUpdateApiKeyResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
organization_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListOrganizationApiKeys 200 responseListOrganizationApiKeysResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
organization_idpathstringtruenone
bodybodyCreateOrganizationApiKeyRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateOrganizationApiKey 201 responseCreateOrganizationApiKeyResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
user_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListApiKeys 200 responseListApiKeysResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
user_idpathstringtruenone
bodybodyCreateApiKeyRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateApiKey 201 responseCreateApiKeyResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
assistant_run_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetAssistantRun 200 responseGetAssistantRunResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
assistant_run_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKCancelAssistantRun 200 responseCancelAssistantRunResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
assistant_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone
statusqueryarray[string]falseComma-separated list of run statuses to filter by.
Enumerated Values
ParameterValue
statusQUEUED
statusSTARTING
statusRUNNING
statusSUCCEEDED
statusFAILED
statusERROR
statusCANCELLED

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

StatusMeaningDescriptionSchema
200OKListAssistantRuns 200 responseListAssistantRunsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
assistant_idpathstringtruenone
bodybodyCreateAssistantRunRequestContentfalsenone

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

StatusMeaningDescriptionSchema
201CreatedCreateAssistantRun 201 responseCreateAssistantRunResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
assistant_run_idpathstringtruenone
limitquerystringfalsenone
offsetquerystringfalsenone

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

StatusMeaningDescriptionSchema
200OKListAssistantEvents 200 responseListAssistantEventsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
assistant_run_idpathstringtruenone

Example responses

200 Response

400 Response

{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetAssistantRunEventsSSE 200 responseGetAssistantRunEventsSSEOutputPayload
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
event_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetEvent 200 responseGetEventResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
structure_run_idpathstringtruenone
limitquerystringfalsenone
offsetquerystringfalsenone

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

StatusMeaningDescriptionSchema
200OKListEvents 200 responseListEventsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
structure_run_idpathstringtruenone
bodybodyCreateEventsRequestContentfalsenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
202AcceptedCreateEvents 202 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
structure_run_idpathstringtruenone

Example responses

200 Response

400 Response

{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetStructureRunEventsSSE 200 responseGetStructureRunEventsSSEOutputPayload
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListAssistants 200 responseListAssistantsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateAssistantRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateAssistant 201 responseCreateAssistantResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
assistant_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteAssistant 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
assistant_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetAssistant 200 responseGetAssistantResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
assistant_idpathstringtruenone
bodybodyUpdateAssistantRequestContentfalsenone

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

StatusMeaningDescriptionSchema
200OKUpdateAssistant 200 responseUpdateAssistantResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateCheckoutSessionRequestContenttruenone

Example responses

201 Response
{
  "properties": {
    "redirect_url": {
      "type": "string"
    }
  },
  "required": [
    "redirect_url"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
201CreatedCreateCheckoutSession 201 responseCreateCheckoutSessionResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

StatusMeaningDescriptionSchema
201CreatedCreateBillingManagementUrl 201 responseCreateBillingManagementUrlResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListBuckets 200 responseListBucketsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateBucketRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateBucket 201 responseCreateBucketResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bucket_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteBucket 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bucket_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetBucket 200 responseGetBucketResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bucket_idpathstringtruenone
bodybodyUpdateBucketRequestContentfalsenone

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

StatusMeaningDescriptionSchema
200OKUpdateBucket 200 responseUpdateBucketResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
namepathstringtruenone
bucket_idpathstringtruenone
bodybodyCreateAssetUrlRequestContentfalsenone

Example responses

200 Response
{
  "properties": {
    "headers": {
      "additionalProperties": {},
      "type": "object"
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "headers",
    "url"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKCreateAssetUrl 200 responseCreateAssetUrlResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bucket_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone
prefixquerystringfalsenone
postfixquerystringfalsenone

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

StatusMeaningDescriptionSchema
200OKListAssets 200 responseListAssetsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bucket_idpathstringtruenone
bodybodyCreateAssetRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateAsset 201 responseCreateAssetResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
namepathstringtruenone
bucket_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteAsset 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
namepathstringtruenone
bucket_idpathstringtruenone
include_contentsquerybooleanfalsetrue/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

StatusMeaningDescriptionSchema
200OKGetAsset 200 responseGetAssetResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateChatMessageRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateChatMessage 201 responseCreateChatMessageResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateChatMessageStreamRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateChatMessageStream 201 responseCreateChatMessageStreamResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

StatusMeaningDescriptionSchema
200OKGetConfig 200 responseGetConfigResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone
typequerystringfalsenone

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

StatusMeaningDescriptionSchema
200OKListConnections 200 responseListConnectionsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateConnectionRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateConnection 201 responseCreateConnectionResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
connection_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteConnection 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
connection_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "access_token": {
      "type": "string"
    }
  },
  "required": [
    "access_token"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetToken 200 responseGetTokenResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
start_timequerystring(date-time)falsenone
end_timequerystring(date-time)falsenone
periodqueryPeriodfalsenone
structure_idsquerystringfalsenone
Enumerated Values
ParameterValue
period1m
period1h
period1d
period1w

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

StatusMeaningDescriptionSchema
200OKGetStructuresDashboard 200 responseGetStructuresDashboardResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

ListStructures

GET /structures

Parameters

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListStructures 200 responseListStructuresResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateStructureRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateStructure 201 responseCreateStructureResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
structure_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteStructure 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
structure_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetStructure 200 responseGetStructureResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
structure_idpathstringtruenone
bodybodyUpdateStructureRequestContentfalsenone

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

StatusMeaningDescriptionSchema
200OKUpdateStructure 200 responseUpdateStructureResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
structure_idpathstringtruenone
api_keyquerystringfalsenone

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

StatusMeaningDescriptionSchema
200OKInvokeStructureWebhookGet 200 responseInvokeStructureWebhookGetResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
structure_idpathstringtruenone
api_keyquerystringfalsenone

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

StatusMeaningDescriptionSchema
200OKInvokeStructureWebhookPost 200 responseInvokeStructureWebhookPostResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListDataConnectors 200 responseListDataConnectorsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateDataConnectorRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateDataConnector 201 responseCreateDataConnectorResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
data_connector_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteDataConnector 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
data_connector_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetDataConnector 200 responseGetDataConnectorResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
data_connector_idpathstringtruenone
bodybodyUpdateDataConnectorRequestContentfalsenone

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

StatusMeaningDescriptionSchema
200OKUpdateDataConnector 200 responseUpdateDataConnectorResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
data_connector_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone
statusqueryarray[string]falseComma-separated list of statuses to filter by.
Enumerated Values
ParameterValue
statusQUEUED
statusRUNNING
statusSUCCEEDED
statusFAILED
statusCANCELLED

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

StatusMeaningDescriptionSchema
200OKListDataJobs 200 responseListDataJobsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
data_connector_idpathstringtruenone

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

StatusMeaningDescriptionSchema
202AcceptedCreateDataJob 202 responseCreateDataJobResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
data_job_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetDataJob 200 responseGetDataJobResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
data_job_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKCancelDataJob 200 responseCancelDataJobResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
deployment_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetDeployment 200 responseGetDeploymentResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
function_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListFunctionDeployments 200 responseListFunctionDeploymentsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
function_idpathstringtruenone
bodybodyCreateFunctionDeploymentRequestContentfalsenone

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

StatusMeaningDescriptionSchema
202AcceptedCreateFunctionDeployment 202 responseCreateFunctionDeploymentResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
structure_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone
statusqueryarray[string]falseComma-separated list of deployment statuses to filter by.
Enumerated Values
ParameterValue
statusQUEUED
statusDEPLOYING
statusSUCCEEDED
statusFAILED
statusERROR

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

StatusMeaningDescriptionSchema
200OKListStructureDeployments 200 responseListStructureDeploymentsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
structure_idpathstringtruenone
bodybodyCreateStructureDeploymentRequestContentfalsenone

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

StatusMeaningDescriptionSchema
202AcceptedCreateStructureDeployment 202 responseCreateStructureDeploymentResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
tool_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListToolDeployments 200 responseListToolDeploymentsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
tool_idpathstringtruenone
bodybodyCreateToolDeploymentRequestContentfalsenone

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

StatusMeaningDescriptionSchema
202AcceptedCreateToolDeployment 202 responseCreateToolDeploymentResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
function_run_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetFunctionRun 200 responseGetFunctionRunResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
function_run_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "logs": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "logs"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListFunctionRunLogs 200 responseListFunctionRunLogsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
function_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone
statusqueryarray[string]falseComma-separated list of run statuses to filter by.
Enumerated Values
ParameterValue
statusQUEUED
statusSTARTING
statusRUNNING
statusSUCCEEDED
statusFAILED
statusERROR
statusCANCELLED

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

StatusMeaningDescriptionSchema
200OKListFunctionRuns 200 responseListFunctionRunsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListFunctions 200 responseListFunctionsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateFunctionRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateFunction 201 responseCreateFunctionResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
function_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteFunction 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
function_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetFunction 200 responseGetFunctionResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
function_idpathstringtruenone
bodybodyUpdateFunctionRequestContentfalsenone

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

StatusMeaningDescriptionSchema
200OKUpdateFunction 200 responseUpdateFunctionResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
function_idpathstringtruenone

Example responses

200 Response
{}

Responses

StatusMeaningDescriptionSchema
200OKCreateFunctionExecutionGet 200 responseCreateFunctionExecutionGetOutputPayload
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
function_idpathstringtruenone
bodybodyCreateFunctionExecutionPostInputPayloadfalsenone

Example responses

200 Response
{}

Responses

StatusMeaningDescriptionSchema
200OKCreateFunctionExecutionPost 200 responseCreateFunctionExecutionPostOutputPayload
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListIntegrations 200 responseListIntegrationsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateIntegrationRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateIntegration 201 responseCreateIntegrationResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
integration_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteIntegration 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
integration_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetIntegration 200 responseGetIntegrationResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
integration_idpathstringtruenone
bodybodyUpdateIntegrationRequestContentfalsenone

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

StatusMeaningDescriptionSchema
200OKUpdateIntegration 200 responseUpdateIntegrationResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListUserInvites 200 responseListUserInvitesResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
invite_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteInvite 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
invite_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetInvite 200 responseGetInviteResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
invite_idpathstringtruenone
bodybodyRespondToInviteRequestContenttruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentRespondToInvite 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
organization_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListInvites 200 responseListInvitesResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
organization_idpathstringtruenone
bodybodyCreateInviteRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateInvite 201 responseCreateInviteResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_job_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetKnowledgeBaseJob 200 responseGetKnowledgeBaseJobResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_job_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKCancelKnowledgeBaseJob 200 responseCancelKnowledgeBaseJobResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone
statusqueryarray[string]falseComma-separated list of statuses to filter by.
Enumerated Values
ParameterValue
statusQUEUED
statusRUNNING
statusSUCCEEDED
statusFAILED
statusCANCELLED

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

StatusMeaningDescriptionSchema
200OKListKnowledgeBaseJobs 200 responseListKnowledgeBaseJobsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_idpathstringtruenone

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

StatusMeaningDescriptionSchema
202AcceptedCreateKnowledgeBaseJob 202 responseCreateKnowledgeBaseJobResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_query_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetKnowledgeBaseQuery 200 responseGetKnowledgeBaseQueryResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_search_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetKnowledgeBaseSearch 200 responseGetKnowledgeBaseSearchResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListKnowledgeBases 200 responseListKnowledgeBasesResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateKnowledgeBaseRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateKnowledgeBase 201 responseCreateKnowledgeBaseResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteKnowledgeBase 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetKnowledgeBase 200 responseGetKnowledgeBaseResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_idpathstringtruenone
bodybodyUpdateKnowledgeBaseRequestContenttruenone

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

StatusMeaningDescriptionSchema
200OKUpdateKnowledgeBase 200 responseUpdateKnowledgeBaseResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListKnowledgeBaseQueries 200 responseListKnowledgeBaseQueriesResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_idpathstringtruenone
bodybodyQueryKnowledgeBaseRequestContentfalsenone

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

StatusMeaningDescriptionSchema
200OKQueryKnowledgeBase 200 responseQueryKnowledgeBaseResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_idpathstringtruenone
bodybodySearchKnowledgeBaseRequestContenttruenone

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

StatusMeaningDescriptionSchema
200OKSearchKnowledgeBase 200 responseSearchKnowledgeBaseResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
knowledge_base_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListKnowledgeBaseSearches 200 responseListKnowledgeBaseSearchesResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListLibraries 200 responseListLibrariesResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateLibraryRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateLibrary 201 responseCreateLibraryResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
library_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteLibrary 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
library_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetLibrary 200 responseGetLibraryResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
library_idpathstringtruenone
bodybodyUpdateLibraryRequestContenttruenone

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

StatusMeaningDescriptionSchema
200OKUpdateLibrary 200 responseUpdateLibraryResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
message_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteMessage 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
message_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetMessage 200 responseGetMessageResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
message_idpathstringtruenone
bodybodyUpdateMessageRequestContentfalsenone

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

StatusMeaningDescriptionSchema
200OKUpdateMessage 200 responseUpdateMessageResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
thread_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone

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

StatusMeaningDescriptionSchema
200OKListMessages 200 responseListMessagesResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
thread_idpathstringtruenone
bodybodyCreateMessageRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateMessage 201 responseCreateMessageResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone
model_typequerystringfalsenone
defaultquerybooleanfalsenone

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

StatusMeaningDescriptionSchema
200OKListModels 200 responseListModelsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

StatusMeaningDescriptionSchema
200OKListOrganizations 200 responseListOrganizationsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
bodybodyCreateOrganizationRequestContenttruenone

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

StatusMeaningDescriptionSchema
201CreatedCreateOrganization 201 responseCreateOrganizationResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
organization_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteOrganization 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
organization_idpathstringtruenone

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

StatusMeaningDescriptionSchema
200OKGetOrganization 200 responseGetOrganizationResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
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

NameInTypeRequiredDescription
organization_idpathstringtruenone
bodybodyUpdateOrganizationRequestContentfalsenone

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

StatusMeaningDescriptionSchema
200OKUpdateOrganization 200 responseUpdateOrganizationResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

ListOrganizationUsers

GET /organizations/{organization_id}/users

Parameters

NameInTypeRequiredDescription
organization_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone

Example responses

200 Response
{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "users": {
      "items": {
        "properties": {
          "email": {
            "type": "string"
          },
          "user_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          }
        },
        "required": [
          "email",
          "user_id"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "users"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListOrganizationUsers 200 responseListOrganizationUsersResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

DeleteOrganizationUser

DELETE /organizations/{organization_id}/users/{user_id}

Parameters

NameInTypeRequiredDescription
organization_idpathstringtruenone
user_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteOrganizationUser 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

RetrieverComponents

ListRetrieverComponents

GET /retriever-components

Parameters

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

Example responses

200 Response
{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_component_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "config",
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_component_id",
          "type",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "retriever_components"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListRetrieverComponents 200 responseListRetrieverComponentsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

CreateRetrieverComponent

POST /retriever-components

Body parameter

{
  "properties": {
    "config": {},
    "description": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "config",
    "name",
    "type"
  ],
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
bodybodyCreateRetrieverComponentRequestContenttruenone

Example responses

201 Response
{
  "properties": {
    "config": {},
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_component_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "config",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_component_id",
    "type",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
201CreatedCreateRetrieverComponent 201 responseCreateRetrieverComponentResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

DeleteRetrieverComponent

DELETE /retriever-components/{retriever_component_id}

Parameters

NameInTypeRequiredDescription
retriever_component_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteRetrieverComponent 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

GetRetrieverComponent

GET /retriever-components/{retriever_component_id}

Parameters

NameInTypeRequiredDescription
retriever_component_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "config": {},
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_component_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "config",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_component_id",
    "type",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetRetrieverComponent 200 responseGetRetrieverComponentResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

UpdateRetrieverComponent

PATCH /retriever-components/{retriever_component_id}

Body parameter

{
  "properties": {
    "config": {},
    "description": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "config",
    "type"
  ],
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
retriever_component_idpathstringtruenone
bodybodyUpdateRetrieverComponentRequestContenttruenone

Example responses

200 Response
{
  "properties": {
    "config": {},
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_component_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "config",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_component_id",
    "type",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKUpdateRetrieverComponent 200 responseUpdateRetrieverComponentResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

Retrievers

ListRetrievers

GET /retrievers

Parameters

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

Example responses

200 Response
{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "retrievers": {
      "items": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_components": {
            "items": {
              "properties": {
                "config": {},
                "created_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "created_by": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "organization_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                },
                "retriever_component_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                },
                "type": {
                  "type": "string"
                },
                "updated_at": {
                  "format": "date-time",
                  "type": "string"
                }
              },
              "required": [
                "config",
                "created_at",
                "created_by",
                "name",
                "organization_id",
                "retriever_component_id",
                "type",
                "updated_at"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "retriever_components_schema": {},
          "retriever_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_components",
          "retriever_components_schema",
          "retriever_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "retrievers"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListRetrievers 200 responseListRetrieversResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

CreateRetriever

POST /retrievers

Body parameter

{
  "properties": {
    "description": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    },
    "retriever_component_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "description": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "name": {
            "maxLength": 64,
            "minLength": 1,
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
bodybodyCreateRetrieverRequestContenttruenone

Example responses

201 Response
{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_component_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "config",
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_component_id",
          "type",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "retriever_components_schema": {},
    "retriever_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_components",
    "retriever_components_schema",
    "retriever_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
201CreatedCreateRetriever 201 responseCreateRetrieverResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

DeleteRetriever

DELETE /retrievers/{retriever_id}

Parameters

NameInTypeRequiredDescription
retriever_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteRetriever 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

GetRetriever

GET /retrievers/{retriever_id}

Parameters

NameInTypeRequiredDescription
retriever_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_component_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "config",
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_component_id",
          "type",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "retriever_components_schema": {},
    "retriever_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_components",
    "retriever_components_schema",
    "retriever_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetRetriever 200 responseGetRetrieverResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

UpdateRetriever

PATCH /retrievers/{retriever_id}

Body parameter

{
  "properties": {
    "description": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    },
    "retriever_component_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "description": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "name": {
            "maxLength": 64,
            "minLength": 1,
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
retriever_idpathstringtruenone
bodybodyUpdateRetrieverRequestContentfalsenone

Example responses

200 Response
{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_component_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "config",
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_component_id",
          "type",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "retriever_components_schema": {},
    "retriever_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_components",
    "retriever_components_schema",
    "retriever_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKUpdateRetriever 200 responseUpdateRetrieverResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

QueryRetriever

POST /retrievers/{retriever_id}/query

Body parameter

{
  "properties": {
    "query": {
      "type": "string"
    },
    "retriever_components_query_args": {}
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
retriever_idpathstringtruenone
bodybodyQueryRetrieverRequestContenttruenone

Example responses

200 Response
{
  "properties": {
    "outputs": {
      "items": {},
      "type": "array"
    }
  },
  "required": [
    "outputs"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKQueryRetriever 200 responseQueryRetrieverResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

Rules

ListRules

GET /rules

Parameters

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone
ruleset_idquerystringfalsenone

Example responses

200 Response
{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "rules": {
      "items": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "rule": {
            "type": "string"
          },
          "rule_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "created_at",
          "created_by",
          "metadata",
          "name",
          "organization_id",
          "rule",
          "rule_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "rules"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListRules 200 responseListRulesResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

CreateRule

POST /rules

Body parameter

{
  "properties": {
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "rule": {
      "maxLength": 2000,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name",
    "rule"
  ],
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
bodybodyCreateRuleRequestContenttruenone

Example responses

201 Response
{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule": {
      "type": "string"
    },
    "rule_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "rule",
    "rule_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
201CreatedCreateRule 201 responseCreateRuleResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

DeleteRule

DELETE /rules/{rule_id}

Parameters

NameInTypeRequiredDescription
rule_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteRule 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

GetRule

GET /rules/{rule_id}

Parameters

NameInTypeRequiredDescription
rule_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule": {
      "type": "string"
    },
    "rule_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "rule",
    "rule_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetRule 200 responseGetRuleResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

UpdateRule

PATCH /rules/{rule_id}

Body parameter

{
  "properties": {
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "rule": {
      "maxLength": 2000,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
rule_idpathstringtruenone
bodybodyUpdateRuleRequestContentfalsenone

Example responses

200 Response
{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule": {
      "type": "string"
    },
    "rule_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "rule",
    "rule_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKUpdateRule 200 responseUpdateRuleResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

Rulesets

ListRulesets

GET /rulesets

Parameters

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone
aliasquerystringfalsenone

Example responses

200 Response
{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "rulesets": {
      "items": {
        "properties": {
          "alias": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "rule_ids": {
            "items": {
              "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
              "type": "string"
            },
            "type": "array"
          },
          "ruleset_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "alias",
          "created_at",
          "created_by",
          "description",
          "metadata",
          "name",
          "organization_id",
          "rule_ids",
          "ruleset_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "rulesets"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListRulesets 200 responseListRulesetsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

CreateRuleset

POST /rulesets

Body parameter

{
  "properties": {
    "alias": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "description": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
bodybodyCreateRulesetRequestContenttruenone

Example responses

201 Response
{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "description",
    "metadata",
    "name",
    "organization_id",
    "rule_ids",
    "ruleset_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
201CreatedCreateRuleset 201 responseCreateRulesetResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

DeleteRuleset

DELETE /rulesets/{ruleset_id}

Parameters

NameInTypeRequiredDescription
ruleset_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteRuleset 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

GetRuleset

GET /rulesets/{ruleset_id}

Parameters

NameInTypeRequiredDescription
ruleset_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "description",
    "metadata",
    "name",
    "organization_id",
    "rule_ids",
    "ruleset_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetRuleset 200 responseGetRulesetResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

UpdateRuleset

PATCH /rulesets/{ruleset_id}

Body parameter

{
  "properties": {
    "alias": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "description": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
ruleset_idpathstringtruenone
bodybodyUpdateRulesetRequestContentfalsenone

Example responses

200 Response
{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "description",
    "metadata",
    "name",
    "organization_id",
    "rule_ids",
    "ruleset_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKUpdateRuleset 200 responseUpdateRulesetResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

Secrets

ListSecrets

GET /secrets

Parameters

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

Example responses

200 Response
{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "secrets": {
      "items": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "last_used": {
            "format": "date-time",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "secret_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "created_at",
          "last_used",
          "name",
          "organization_id",
          "secret_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "secrets"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListSecrets 200 responseListSecretsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

CreateSecret

POST /secrets

Body parameter

{
  "properties": {
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "value": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name",
    "value"
  ],
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
bodybodyCreateSecretRequestContenttruenone

Example responses

201 Response
{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "secret_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "last_used",
    "name",
    "organization_id",
    "secret_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
201CreatedCreateSecret 201 responseCreateSecretResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

DeleteSecret

DELETE /secrets/{secret_id}

Parameters

NameInTypeRequiredDescription
secret_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteSecret 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

GetSecret

GET /secrets/{secret_id}

Parameters

NameInTypeRequiredDescription
secret_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "secret_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "last_used",
    "name",
    "organization_id",
    "secret_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetSecret 200 responseGetSecretResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

UpdateSecret

PATCH /secrets/{secret_id}

Body parameter

{
  "properties": {
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "value": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
secret_idpathstringtruenone
bodybodyUpdateSecretRequestContentfalsenone

Example responses

200 Response
{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "secret_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "last_used",
    "name",
    "organization_id",
    "secret_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKUpdateSecret 200 responseUpdateSecretResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

StructureRuns

GetStructureRun

GET /structure-runs/{structure_run_id}

Parameters

NameInTypeRequiredDescription
structure_run_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "output": {},
    "output_timestamp": {
      "format": "double",
      "type": "number"
    },
    "started_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "structure_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "structure_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "completed_at",
    "created_at",
    "created_by",
    "started_at",
    "status",
    "structure_id",
    "structure_run_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetStructureRun 200 responseGetStructureRunResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

CancelStructureRun

POST /structure-runs/{structure_run_id}/cancel

Parameters

NameInTypeRequiredDescription
structure_run_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "output": {},
    "output_timestamp": {
      "format": "double",
      "type": "number"
    },
    "started_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "structure_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "structure_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "completed_at",
    "created_at",
    "created_by",
    "started_at",
    "status",
    "structure_id",
    "structure_run_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKCancelStructureRun 200 responseCancelStructureRunResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

ListStructureRunLogs

GET /structure-runs/{structure_run_id}/logs

Parameters

NameInTypeRequiredDescription
structure_run_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "logs": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "logs"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListStructureRunLogs 200 responseListStructureRunLogsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

ListStructureRuns

GET /structures/{structure_id}/runs

Parameters

NameInTypeRequiredDescription
structure_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone
statusqueryarray[string]falseComma-separated list of run statuses to filter by.
Enumerated Values
ParameterValue
statusQUEUED
statusSTARTING
statusRUNNING
statusSUCCEEDED
statusFAILED
statusERROR
statusCANCELLED

Example responses

200 Response
{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "structure_runs": {
      "items": {
        "properties": {
          "args": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "completed_at": {
            "default": null,
            "format": "date-time",
            "type": "string",
            "nullable": true
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "deployment_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "env_vars": {
            "items": {
              "properties": {
                "name": {
                  "type": "string"
                },
                "source": {
                  "enum": [
                    "secret_ref",
                    "manual"
                  ],
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "value"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "output": {},
          "output_timestamp": {
            "format": "double",
            "type": "number"
          },
          "started_at": {
            "default": null,
            "format": "date-time",
            "type": "string",
            "nullable": true
          },
          "status": {
            "enum": [
              "QUEUED",
              "STARTING",
              "RUNNING",
              "SUCCEEDED",
              "FAILED",
              "ERROR",
              "CANCELLED"
            ],
            "type": "string"
          },
          "status_detail": {},
          "structure_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "structure_run_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "args",
          "completed_at",
          "created_at",
          "created_by",
          "started_at",
          "status",
          "structure_id",
          "structure_run_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "structure_runs"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListStructureRuns 200 responseListStructureRunsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

CreateStructureRun

POST /structures/{structure_id}/runs

Body parameter

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "args"
  ],
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
structure_idpathstringtruenone
bodybodyCreateStructureRunRequestContenttruenone

Example responses

201 Response
{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "output": {},
    "output_timestamp": {
      "format": "double",
      "type": "number"
    },
    "started_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "structure_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "structure_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "completed_at",
    "created_at",
    "created_by",
    "started_at",
    "status",
    "structure_id",
    "structure_run_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
201CreatedCreateStructureRun 201 responseCreateStructureRunResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

Spans

ListSpans

GET /structure-runs/{structure_run_id}/spans

Parameters

NameInTypeRequiredDescription
structure_run_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone

Example responses

200 Response
{
  "properties": {
    "page": {
      "type": "number"
    },
    "spans": {
      "items": {
        "properties": {
          "attributes": {},
          "end_time": {
            "format": "date-time",
            "type": "string"
          },
          "events": {
            "properties": {
              "attributes": {},
              "name": {
                "type": "string"
              },
              "timestamp": {
                "format": "date-time",
                "type": "string"
              }
            },
            "required": [
              "attributes",
              "name",
              "timestamp"
            ],
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "parent_id": {
            "type": "string"
          },
          "span_id": {
            "type": "string"
          },
          "start_time": {
            "format": "date-time",
            "type": "string"
          },
          "status": {
            "enum": [
              "UNSET",
              "OK",
              "ERROR"
            ],
            "type": "string"
          },
          "trace_id": {
            "type": "string"
          }
        },
        "required": [
          "attributes",
          "end_time",
          "events",
          "name",
          "span_id",
          "start_time",
          "status",
          "trace_id"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "spans"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListSpans 200 responseListSpansResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

Threads

ListThreads

GET /threads

Parameters

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone
aliasquerystringfalsenone

Example responses

200 Response
{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "threads": {
      "items": {
        "properties": {
          "alias": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "thread_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "alias",
          "created_at",
          "created_by",
          "metadata",
          "name",
          "organization_id",
          "thread_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "threads"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListThreads 200 responseListThreadsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

CreateThread

POST /threads

Body parameter

{
  "properties": {
    "alias": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "messages": {
      "items": {
        "properties": {
          "input": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "output": {
            "type": "string"
          }
        },
        "required": [
          "input",
          "output"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
bodybodyCreateThreadRequestContenttruenone

Example responses

201 Response
{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "thread_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
201CreatedCreateThread 201 responseCreateThreadResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

DeleteThread

DELETE /threads/{thread_id}

Parameters

NameInTypeRequiredDescription
thread_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteThread 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

GetThread

GET /threads/{thread_id}

Parameters

NameInTypeRequiredDescription
thread_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "thread_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetThread 200 responseGetThreadResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

UpdateThread

PATCH /threads/{thread_id}

Body parameter

{
  "properties": {
    "alias": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "messages": {
      "items": {
        "properties": {
          "input": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "output": {
            "type": "string"
          }
        },
        "required": [
          "input",
          "output"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
thread_idpathstringtruenone
bodybodyUpdateThreadRequestContentfalsenone

Example responses

200 Response
{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "thread_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKUpdateThread 200 responseUpdateThreadResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

ToolRuns

GetToolRun

GET /tool-runs/{tool_run_id}

Parameters

NameInTypeRequiredDescription
tool_run_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "input": {},
    "output": {},
    "output_timestamp": {
      "format": "double",
      "type": "number"
    },
    "runtime_path": {
      "type": "string"
    },
    "started_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "tool_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "completed_at",
    "created_at",
    "created_by",
    "input",
    "runtime_path",
    "started_at",
    "status",
    "tool_id",
    "tool_run_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetToolRun 200 responseGetToolRunResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

ListToolRunLogs

GET /tool-runs/{tool_run_id}/logs

Parameters

NameInTypeRequiredDescription
tool_run_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "logs": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "logs"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListToolRunLogs 200 responseListToolRunLogsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

ListToolRuns

GET /tools/{tool_id}/runs

Parameters

NameInTypeRequiredDescription
tool_idpathstringtruenone
pagequerynumberfalsenone
page_sizequerynumberfalsenone
statusqueryarray[string]falseComma-separated list of run statuses to filter by.
Enumerated Values
ParameterValue
statusQUEUED
statusSTARTING
statusRUNNING
statusSUCCEEDED
statusFAILED
statusERROR
statusCANCELLED

Example responses

200 Response
{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "tool_runs": {
      "items": {
        "properties": {
          "completed_at": {
            "default": null,
            "format": "date-time",
            "type": "string",
            "nullable": true
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "deployment_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "env_vars": {
            "items": {
              "properties": {
                "name": {
                  "type": "string"
                },
                "source": {
                  "enum": [
                    "secret_ref",
                    "manual"
                  ],
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "value"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "input": {},
          "output": {},
          "output_timestamp": {
            "format": "double",
            "type": "number"
          },
          "runtime_path": {
            "type": "string"
          },
          "started_at": {
            "default": null,
            "format": "date-time",
            "type": "string",
            "nullable": true
          },
          "status": {
            "enum": [
              "QUEUED",
              "STARTING",
              "RUNNING",
              "SUCCEEDED",
              "FAILED",
              "ERROR",
              "CANCELLED"
            ],
            "type": "string"
          },
          "status_detail": {},
          "tool_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "tool_run_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "completed_at",
          "created_at",
          "created_by",
          "input",
          "runtime_path",
          "started_at",
          "status",
          "tool_id",
          "tool_run_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "tool_runs"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListToolRuns 200 responseListToolRunsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

Tools

ListTools

GET /tools

Parameters

NameInTypeRequiredDescription
pagequerynumberfalsenone
page_sizequerynumberfalsenone

Example responses

200 Response
{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "tools": {
      "items": {
        "properties": {
          "code": {
            "oneOf": [
              {
                "properties": {
                  "github": {
                    "properties": {
                      "name": {
                        "maxLength": 200,
                        "minLength": 1,
                        "type": "string"
                      },
                      "owner": {
                        "maxLength": 200,
                        "minLength": 1,
                        "type": "string"
                      },
                      "push": {
                        "properties": {
                          "branch": {
                            "maxLength": 200,
                            "minLength": 1,
                            "type": "string"
                          },
                          "tag": {
                            "maxLength": 200,
                            "minLength": 1,
                            "type": "string"
                          }
                        },
                        "required": [
                          "branch"
                        ],
                        "type": "object"
                      }
                    },
                    "required": [
                      "name",
                      "owner",
                      "push"
                    ],
                    "type": "object"
                  }
                },
                "required": [
                  "github"
                ],
                "title": "github",
                "type": "object"
              },
              {
                "properties": {
                  "data_lake": {
                    "properties": {
                      "asset_path": {
                        "type": "string"
                      },
                      "bucket_id": {
                        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                        "type": "string"
                      }
                    },
                    "required": [
                      "asset_path",
                      "bucket_id"
                    ],
                    "type": "object"
                  }
                },
                "required": [
                  "data_lake"
                ],
                "title": "data_lake",
                "type": "object"
              },
              {
                "properties": {
                  "default": {
                    "type": "object"
                  }
                },
                "required": [
                  "default"
                ],
                "title": "default",
                "type": "object"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "env_vars": {
            "items": {
              "properties": {
                "name": {
                  "type": "string"
                },
                "source": {
                  "enum": [
                    "secret_ref",
                    "manual"
                  ],
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "value"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "latest_deployment_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "tool_config_file": {
            "type": "string"
          },
          "tool_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "code",
          "created_at",
          "created_by",
          "description",
          "env_vars",
          "latest_deployment_id",
          "name",
          "organization_id",
          "tool_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "tools"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKListTools 200 responseListToolsResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

CreateTool

POST /tools

Body parameter

{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "description": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "tool_config_file": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
bodybodyCreateToolRequestContenttruenone

Example responses

201 Response
{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "latest_deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_config_file": {
      "type": "string"
    },
    "tool_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "code",
    "created_at",
    "created_by",
    "description",
    "env_vars",
    "latest_deployment_id",
    "name",
    "organization_id",
    "tool_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
201CreatedCreateTool 201 responseCreateToolResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

DeleteTool

DELETE /tools/{tool_id}

Parameters

NameInTypeRequiredDescription
tool_idpathstringtruenone

Example responses

400 Response
{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
204No ContentDeleteTool 204 responseNone
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

GetTool

GET /tools/{tool_id}

Parameters

NameInTypeRequiredDescription
tool_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "latest_deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_config_file": {
      "type": "string"
    },
    "tool_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "code",
    "created_at",
    "created_by",
    "description",
    "env_vars",
    "latest_deployment_id",
    "name",
    "organization_id",
    "tool_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetTool 200 responseGetToolResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

UpdateTool

PATCH /tools/{tool_id}

Body parameter

{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "description": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "tool_config_file": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Parameters

NameInTypeRequiredDescription
tool_idpathstringtruenone
bodybodyUpdateToolRequestContentfalsenone

Example responses

200 Response
{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "latest_deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_config_file": {
      "type": "string"
    },
    "tool_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "code",
    "created_at",
    "created_by",
    "description",
    "env_vars",
    "latest_deployment_id",
    "name",
    "organization_id",
    "tool_id",
    "updated_at"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKUpdateTool 200 responseUpdateToolResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

ToolInvoke

CreateToolActivityRun

POST /tools/{tool_id}/activities/{activity_path}

Body parameter

{}

Parameters

NameInTypeRequiredDescription
tool_idpathstringtruenone
activity_pathpathstringtruenone
bodybodyCreateToolActivityRunInputPayloadfalsenone

Example responses

200 Response
{}

Responses

StatusMeaningDescriptionSchema
200OKCreateToolActivityRun 200 responseCreateToolActivityRunOutputPayload
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

GetToolOpenApiRun

GET /tools/{tool_id}/openapi

Parameters

NameInTypeRequiredDescription
tool_idpathstringtruenone

Example responses

200 Response
{}

Responses

StatusMeaningDescriptionSchema
200OKGetToolOpenApiRun 200 responseGetToolOpenApiRunOutputPayload
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

Usage

GetUsage

GET /usage

Example responses

200 Response
{
  "properties": {
    "bytes_ingested": {
      "type": "number"
    },
    "bytes_ingested_limit": {
      "type": "number"
    },
    "rag_queries": {
      "type": "number"
    },
    "rag_queries_limit": {
      "type": "number"
    },
    "runtime_seconds": {
      "type": "number"
    },
    "runtime_seconds_limit": {
      "type": "number"
    },
    "usage_period_end": {
      "format": "date-time",
      "type": "string"
    },
    "usage_period_start": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "bytes_ingested",
    "bytes_ingested_limit",
    "rag_queries",
    "rag_queries_limit",
    "runtime_seconds",
    "runtime_seconds_limit",
    "usage_period_end",
    "usage_period_start"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetUsage 200 responseGetUsageResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

Users

GetUser

GET /users/{user_id}

Parameters

NameInTypeRequiredDescription
user_idpathstringtruenone

Example responses

200 Response
{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organizations": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    },
    "user_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "email",
    "organizations",
    "updated_at",
    "user_id"
  ],
  "type": "object"
}

Responses

StatusMeaningDescriptionSchema
200OKGetUser 200 responseGetUserResponseContent
400Bad RequestClientError 400 responseClientErrorResponseContent
500Internal Server ErrorServiceError 500 responseServiceErrorResponseContent
Warning

To perform this operation, you must be authenticated by means of one of the following methods: smithy.api.httpBearerAuth

Schemas

ActivityDuration

{
  "properties": {
    "activity_type": {
      "type": "string"
    },
    "seconds": {
      "type": "number"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
activity_typestringfalsenonenone
secondsnumberfalsenonenone

ApiKeyDetail

{
  "properties": {
    "active": {
      "type": "boolean"
    },
    "api_key_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "active",
    "api_key_id",
    "created_at",
    "created_by",
    "last_used",
    "name",
    "organization_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
activebooleantruenonenone
api_key_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
last_usedstring(date-time)truenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

Artifact

{
  "properties": {
    "id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "meta": {},
    "name": {
      "type": "string"
    },
    "reference": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "value": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "name",
    "type",
    "value"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
idstringtruenonenone
metaanyfalsenonenone
namestringtruenonenone
referencestringfalsenonenone
typestringtruenonenone
valuestringtruenonenone

AssertUrlOperation

{
  "enum": [
    "PUT",
    "GET"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousPUT
anonymousGET

AssetDetail

{
  "properties": {
    "bucket_id": {
      "type": "string"
    },
    "contents": {},
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "size": {
      "type": "number"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bucket_idstringfalsenonenone
contentsanyfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
sizenumberfalsenonenone
updated_atstring(date-time)truenonenone

AssistantDetail

{
  "properties": {
    "assistant_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "assistant_id",
    "created_at",
    "created_by",
    "description",
    "knowledge_base_ids",
    "name",
    "organization_id",
    "retriever_ids",
    "ruleset_ids",
    "structure_ids",
    "tool_ids",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
inputstringfalsenonenone
knowledge_base_ids[string]truenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_ids[string]truenonenone
ruleset_ids[string]truenonenone
structure_ids[string]truenonenone
tool_ids[string]truenonenone
updated_atstring(date-time)truenonenone

AssistantEventDetail

{
  "properties": {
    "assistant_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "event_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "origin": {
      "type": "string"
    },
    "payload": {},
    "timestamp": {
      "format": "double",
      "type": "number"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "assistant_run_id",
    "created_at",
    "event_id",
    "origin",
    "payload",
    "timestamp",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_run_idstringtruenonenone
created_atstring(date-time)truenonenone
event_idstringtruenonenone
originstringtruenonenone
payloadanytruenonenone
timestampnumber(double)truenonenone
typestringtruenonenone

AssistantRunDetail

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "assistant_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "assistant_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "output": {},
    "retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "stream": {
      "type": "boolean"
    },
    "structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "assistant_id",
    "assistant_run_id",
    "completed_at",
    "created_at",
    "created_by",
    "knowledge_base_ids",
    "retriever_ids",
    "ruleset_ids",
    "status",
    "stream",
    "structure_ids",
    "tool_ids",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]truenonenone
assistant_idstringtruenonenone
assistant_run_idstringtruenonenone
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
inputstringfalsenonenone
knowledge_base_ids[string]truenonenone
outputanyfalsenonenone
retriever_ids[string]truenonenone
ruleset_ids[string]truenonenone
statusAssistantRunStatustruenonenone
status_detailanyfalsenonenone
streambooleantruenonenone
structure_ids[string]truenonenone
thread_idstringfalsenonenone
tool_ids[string]truenonenone
updated_atstring(date-time)truenonenone

AssistantRunStatus

{
  "enum": [
    "QUEUED",
    "STARTING",
    "RUNNING",
    "SUCCEEDED",
    "FAILED",
    "ERROR",
    "CANCELLED"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousQUEUED
anonymousSTARTING
anonymousRUNNING
anonymousSUCCEEDED
anonymousFAILED
anonymousERROR
anonymousCANCELLED

BucketDetail

{
  "properties": {
    "bucket_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "bucket_id",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bucket_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

CancelAssistantRunResponseContent

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "assistant_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "assistant_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "output": {},
    "retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "stream": {
      "type": "boolean"
    },
    "structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "assistant_id",
    "assistant_run_id",
    "completed_at",
    "created_at",
    "created_by",
    "knowledge_base_ids",
    "retriever_ids",
    "ruleset_ids",
    "status",
    "stream",
    "structure_ids",
    "tool_ids",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]truenonenone
assistant_idstringtruenonenone
assistant_run_idstringtruenonenone
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
inputstringfalsenonenone
knowledge_base_ids[string]truenonenone
outputanyfalsenonenone
retriever_ids[string]truenonenone
ruleset_ids[string]truenonenone
statusAssistantRunStatustruenonenone
status_detailanyfalsenonenone
streambooleantruenonenone
structure_ids[string]truenonenone
thread_idstringfalsenonenone
tool_ids[string]truenonenone
updated_atstring(date-time)truenonenone

CancelDataJobResponseContent

{
  "properties": {
    "bytes_ingested": {
      "type": "number"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "data_connector_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "data_job_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "errors": {
      "items": {
        "properties": {
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "message",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "status": {
      "enum": [
        "QUEUED",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {}
  },
  "required": [
    "created_at",
    "created_by",
    "data_connector_id",
    "data_job_id",
    "status"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bytes_ingestednumberfalsenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_idstringtruenonenone
data_job_idstringtruenonenone
errors[Error]falsenonenone
statusDataJobStatustruenonenone
status_detailanyfalsenonenone

CancelKnowledgeBaseJobResponseContent

{
  "properties": {
    "bytes_ingested": {
      "type": "number"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "errors": {
      "items": {
        "properties": {
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "message",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "knowledge_base_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "knowledge_base_job_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "status": {
      "enum": [
        "QUEUED",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {}
  },
  "required": [
    "created_at",
    "created_by",
    "knowledge_base_id",
    "knowledge_base_job_id",
    "status"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bytes_ingestednumberfalsenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
errors[Error]falsenonenone
knowledge_base_idstringtruenonenone
knowledge_base_job_idstringtruenonenone
statusKnowledgeBaseJobStatustruenonenone
status_detailanyfalsenonenone

CancelStructureRunResponseContent

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "output": {},
    "output_timestamp": {
      "format": "double",
      "type": "number"
    },
    "started_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "structure_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "structure_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "completed_at",
    "created_at",
    "created_by",
    "started_at",
    "status",
    "structure_id",
    "structure_run_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]truenonenone
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringfalsenonenone
env_vars[EnvVar]falsenonenone
outputanyfalsenonenone
output_timestampnumber(double)falsenonenone
started_atstring(date-time)¦nulltruenonenone
statusStructureRunStatustruenonenone
status_detailanyfalsenonenone
structure_idstringtruenonenone
structure_run_idstringtruenonenone
updated_atstring(date-time)truenonenone

ChatMessageDriverConfiguration

{
  "properties": {
    "extra_params": {},
    "max_tokens": {
      "type": "number"
    },
    "model": {
      "type": "string"
    },
    "structured_output_strategy": {
      "type": "string"
    },
    "temperature": {
      "format": "float",
      "type": "number"
    },
    "use_native_tools": {
      "type": "boolean"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
extra_paramsanyfalsenonenone
max_tokensnumberfalsenonenone
modelstringfalsenonenone
structured_output_strategystringfalsenonenone
temperaturenumber(float)falsenonenone
use_native_toolsbooleanfalsenonenone

ChatMessageMessage

{
  "properties": {
    "content": {
      "items": {
        "properties": {
          "artifact": {
            "properties": {
              "id": {
                "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                "type": "string"
              },
              "meta": {},
              "name": {
                "type": "string"
              },
              "reference": {
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "name",
              "type",
              "value"
            ],
            "type": "object"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "artifact",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "role": {
      "type": "string"
    },
    "usage": {
      "properties": {
        "input_tokens": {
          "type": "number"
        },
        "output_tokens": {
          "type": "number"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "input_tokens",
        "output_tokens",
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "content",
    "role",
    "usage"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
content[MessageContent]truenonenone
rolestringtruenonenone
usageChatMessageUsagetruenonenone

ChatMessageTool

{
  "properties": {
    "activities": {
      "items": {
        "properties": {
          "description": {
            "type": "string"
          },
          "json_schema": {
            "properties": {
              "additionalProperties": {
                "type": "boolean"
              },
              "description": {
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "properties": {
                "properties": {
                  "member": {
                    "properties": {
                      "additionalProperties": {
                        "type": "boolean"
                      },
                      "description": {
                        "type": "string"
                      },
                      "properties": "[Circular]",
                      "required": {
                        "items": {
                          "type": "string"
                        },
                        "type": "array"
                      },
                      "type": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "additionalProperties",
                      "description",
                      "properties",
                      "required",
                      "type"
                    ],
                    "type": "object"
                  }
                },
                "type": "object"
              },
              "required": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "schema": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "additionalProperties",
              "description",
              "id",
              "properties",
              "required",
              "schema",
              "title",
              "type"
            ],
            "type": "object"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "description",
          "json_schema",
          "name"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "name": {
      "type": "string"
    }
  },
  "required": [
    "activities",
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
activities[ChatMessageToolActivity]truenonenone
namestringtruenonenone

ChatMessageToolActivity

{
  "properties": {
    "description": {
      "type": "string"
    },
    "json_schema": {
      "properties": {
        "additionalProperties": {
          "type": "boolean"
        },
        "description": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "properties": {
          "properties": {
            "member": {
              "properties": {
                "additionalProperties": {
                  "type": "boolean"
                },
                "description": {
                  "type": "string"
                },
                "properties": "[Circular]",
                "required": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "additionalProperties",
                "description",
                "properties",
                "required",
                "type"
              ],
              "type": "object"
            }
          },
          "type": "object"
        },
        "required": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "schema": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "additionalProperties",
        "description",
        "id",
        "properties",
        "required",
        "schema",
        "title",
        "type"
      ],
      "type": "object"
    },
    "name": {
      "type": "string"
    }
  },
  "required": [
    "description",
    "json_schema",
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
descriptionstringtruenonenone
json_schemaJsonSchematruenonenone
namestringtruenonenone

ChatMessageUsage

{
  "properties": {
    "input_tokens": {
      "type": "number"
    },
    "output_tokens": {
      "type": "number"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "input_tokens",
    "output_tokens",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
input_tokensnumbertruenonenone
output_tokensnumbertruenonenone
typestringtruenonenone

ClientErrorResponseContent

{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
errors[any]falsenonenone
typestringtruenonenone

CodeSource

{
  "oneOf": [
    {
      "properties": {
        "github": {
          "properties": {
            "commit_sha": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "required": [
        "github"
      ],
      "title": "github",
      "type": "object"
    },
    {
      "properties": {
        "data_lake": {
          "properties": {
            "asset_path": {
              "type": "string"
            },
            "bucket_id": {
              "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
              "type": "string"
            }
          },
          "required": [
            "asset_path",
            "bucket_id"
          ],
          "type": "object"
        }
      },
      "required": [
        "data_lake"
      ],
      "title": "data_lake",
      "type": "object"
    }
  ]
}

Properties

oneOf

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» githubGithubCodeSourcetruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» data_lakeDataLakeCodeSourcetruenonenone

CodeSourceInput

{
  "oneOf": [
    {
      "properties": {
        "github": {
          "properties": {
            "access_token": {
              "maxLength": 1000,
              "minLength": 1,
              "type": "string"
            },
            "commit_sha": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "required": [
        "github"
      ],
      "title": "github",
      "type": "object"
    }
  ]
}

Properties

NameTypeRequiredRestrictionsDescription
githubGithubCodeSourceInputtruenonenone

ConfluenceDetail

{
  "properties": {
    "atlassian_email": {
      "type": "string"
    },
    "domain": {
      "type": "string"
    }
  },
  "required": [
    "atlassian_email",
    "domain"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
atlassian_emailstringtruenonenone
domainstringtruenonenone

ConfluenceInput

{
  "properties": {
    "atlassian_api_token": {
      "type": "string"
    },
    "atlassian_email": {
      "type": "string"
    },
    "domain": {
      "type": "string"
    }
  },
  "required": [
    "atlassian_api_token",
    "atlassian_email",
    "domain"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
atlassian_api_tokenstringtruenonenone
atlassian_emailstringtruenonenone
domainstringtruenonenone

ConnectionCredentialsInput

{
  "oneOf": [
    {
      "properties": {
        "github": {
          "properties": {
            "auth_code": {
              "type": "string"
            }
          },
          "required": [
            "auth_code"
          ],
          "type": "object"
        }
      },
      "required": [
        "github"
      ],
      "title": "github",
      "type": "object"
    }
  ]
}

Properties

NameTypeRequiredRestrictionsDescription
githubGitHubCredentialsInputtruenonenone

ConnectionDetail

{
  "properties": {
    "connection_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "connection_id",
    "created_at",
    "created_by",
    "name",
    "type",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
connection_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
namestringtruenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone

CreateApiKeyRequestContent

{
  "properties": {
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringtruenonenone

CreateApiKeyResponseContent

{
  "properties": {
    "active": {
      "type": "boolean"
    },
    "api_key_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    },
    "value": {
      "type": "string"
    }
  },
  "required": [
    "active",
    "api_key_id",
    "created_at",
    "created_by",
    "last_used",
    "name",
    "organization_id",
    "updated_at",
    "value"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
activebooleantruenonenone
api_key_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
last_usedstring(date-time)truenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone
valuestringtruenonenone

CreateAssetRequestContent

{
  "properties": {
    "name": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringtruenonenone

CreateAssetResponseContent

{
  "properties": {
    "bucket_id": {
      "type": "string"
    },
    "contents": {},
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "size": {
      "type": "number"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bucket_idstringfalsenonenone
contentsanyfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
sizenumberfalsenonenone
updated_atstring(date-time)truenonenone

CreateAssetUrlRequestContent

{
  "properties": {
    "operation": {
      "enum": [
        "PUT",
        "GET"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
operationAssertUrlOperationfalsenonenone

CreateAssetUrlResponseContent

{
  "properties": {
    "headers": {
      "additionalProperties": {},
      "type": "object"
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "headers",
    "url"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
headersMetadatatruenonenone
urlstringtruenonenone

CreateAssistantRequestContent

{
  "properties": {
    "description": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
descriptionstringfalsenonenone
inputstringfalsenonenone
knowledge_base_ids[string]falsenonenone
namestringtruenonenone
retriever_ids[string]falsenonenone
ruleset_ids[string]falsenonenone
structure_ids[string]falsenonenone
tool_ids[string]falsenonenone

CreateAssistantResponseContent

{
  "properties": {
    "assistant_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "assistant_id",
    "created_at",
    "created_by",
    "description",
    "knowledge_base_ids",
    "name",
    "organization_id",
    "retriever_ids",
    "ruleset_ids",
    "structure_ids",
    "tool_ids",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
inputstringfalsenonenone
knowledge_base_ids[string]truenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_ids[string]truenonenone
ruleset_ids[string]truenonenone
structure_ids[string]truenonenone
tool_ids[string]truenonenone
updated_atstring(date-time)truenonenone

CreateAssistantRunRequestContent

{
  "properties": {
    "additional_knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "additional_retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "additional_ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "additional_structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "additional_tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "input": {
      "type": "string"
    },
    "knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "new_thread": {
      "description": "If true, create a new thread for this run to be returned in the response thread_id.",
      "type": "boolean"
    },
    "retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "stream": {
      "type": "boolean"
    },
    "structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "thread_id": {
      "description": "If provided, the run will be associated with the given thread. This takes precedence over new_thread.",
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
additional_knowledge_base_ids[string]falsenonenone
additional_retriever_ids[string]falsenonenone
additional_ruleset_ids[string]falsenonenone
additional_structure_ids[string]falsenonenone
additional_tool_ids[string]falsenonenone
args[string]falsenonenone
inputstringfalsenonenone
knowledge_base_ids[string]falsenonenone
new_threadbooleanfalsenoneIf true, create a new thread for this run to be returned in the response thread_id.
retriever_ids[string]falsenonenone
ruleset_ids[string]falsenonenone
streambooleanfalsenonenone
structure_ids[string]falsenonenone
thread_idstringfalsenoneIf provided, the run will be associated with the given thread. This takes precedence over new_thread.
tool_ids[string]falsenonenone

CreateAssistantRunResponseContent

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "assistant_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "assistant_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "output": {},
    "retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "stream": {
      "type": "boolean"
    },
    "structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "assistant_id",
    "assistant_run_id",
    "completed_at",
    "created_at",
    "created_by",
    "knowledge_base_ids",
    "retriever_ids",
    "ruleset_ids",
    "status",
    "stream",
    "structure_ids",
    "tool_ids",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]truenonenone
assistant_idstringtruenonenone
assistant_run_idstringtruenonenone
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
inputstringfalsenonenone
knowledge_base_ids[string]truenonenone
outputanyfalsenonenone
retriever_ids[string]truenonenone
ruleset_ids[string]truenonenone
statusAssistantRunStatustruenonenone
status_detailanyfalsenonenone
streambooleantruenonenone
structure_ids[string]truenonenone
thread_idstringfalsenonenone
tool_ids[string]truenonenone
updated_atstring(date-time)truenonenone

CreateBillingManagementUrlResponseContent

{
  "properties": {
    "billing_management_url": {
      "type": "string"
    }
  },
  "required": [
    "billing_management_url"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
billing_management_urlstringtruenonenone

CreateBucketRequestContent

{
  "properties": {
    "name": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringtruenonenone

CreateBucketResponseContent

{
  "properties": {
    "bucket_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "bucket_id",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bucket_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateChatMessageRequestContent

{
  "properties": {
    "driver_configuration": {
      "properties": {
        "extra_params": {},
        "max_tokens": {
          "type": "number"
        },
        "model": {
          "type": "string"
        },
        "structured_output_strategy": {
          "type": "string"
        },
        "temperature": {
          "format": "float",
          "type": "number"
        },
        "use_native_tools": {
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "messages": {
      "items": {
        "properties": {
          "content": {
            "items": {
              "properties": {
                "artifact": {
                  "properties": {
                    "id": {
                      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                      "type": "string"
                    },
                    "meta": {},
                    "name": {
                      "type": "string"
                    },
                    "reference": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    },
                    "value": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "type",
                    "value"
                  ],
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "artifact",
                "type"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "role": {
            "type": "string"
          },
          "usage": {
            "properties": {
              "input_tokens": {
                "type": "number"
              },
              "output_tokens": {
                "type": "number"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "input_tokens",
              "output_tokens",
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "content",
          "role",
          "usage"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "output_schema": {
      "properties": {
        "additionalProperties": {
          "type": "boolean"
        },
        "description": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "properties": {
          "properties": {
            "member": {
              "properties": {
                "additionalProperties": {
                  "type": "boolean"
                },
                "description": {
                  "type": "string"
                },
                "properties": "[Circular]",
                "required": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "additionalProperties",
                "description",
                "properties",
                "required",
                "type"
              ],
              "type": "object"
            }
          },
          "type": "object"
        },
        "required": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "schema": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "additionalProperties",
        "description",
        "id",
        "properties",
        "required",
        "schema",
        "title",
        "type"
      ],
      "type": "object"
    },
    "tools": {
      "items": {
        "properties": {
          "activities": {
            "items": {
              "properties": {
                "description": {
                  "type": "string"
                },
                "json_schema": {
                  "properties": {
                    "additionalProperties": {
                      "type": "boolean"
                    },
                    "description": {
                      "type": "string"
                    },
                    "id": {
                      "type": "string"
                    },
                    "properties": {
                      "properties": {
                        "member": {
                          "properties": {
                            "additionalProperties": {
                              "type": "boolean"
                            },
                            "description": {
                              "type": "string"
                            },
                            "properties": "[Circular]",
                            "required": {
                              "items": {
                                "type": "string"
                              },
                              "type": "array"
                            },
                            "type": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "additionalProperties",
                            "description",
                            "properties",
                            "required",
                            "type"
                          ],
                          "type": "object"
                        }
                      },
                      "type": "object"
                    },
                    "required": {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "schema": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "additionalProperties",
                    "description",
                    "id",
                    "properties",
                    "required",
                    "schema",
                    "title",
                    "type"
                  ],
                  "type": "object"
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "description",
                "json_schema",
                "name"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "activities",
          "name"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "driver_configuration",
    "messages",
    "output_schema",
    "tools"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
driver_configurationChatMessageDriverConfigurationtruenonenone
messages[ChatMessageMessage]truenonenone
output_schemaJsonSchematruenonenone
tools[ChatMessageTool]truenonenone

CreateChatMessageResponseContent

{
  "properties": {
    "content": {
      "items": {
        "properties": {
          "artifact": {
            "properties": {
              "id": {
                "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                "type": "string"
              },
              "meta": {},
              "name": {
                "type": "string"
              },
              "reference": {
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "name",
              "type",
              "value"
            ],
            "type": "object"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "artifact",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "role": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "usage": {
      "properties": {
        "input_tokens": {
          "type": "number"
        },
        "output_tokens": {
          "type": "number"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "input_tokens",
        "output_tokens",
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "content",
    "role",
    "type",
    "usage"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
content[MessageContent]truenonenone
rolestringtruenonenone
typestringtruenonenone
usageChatMessageUsagetruenonenone

CreateChatMessageStreamRequestContent

{
  "properties": {
    "driver_configuration": {
      "properties": {
        "extra_params": {},
        "max_tokens": {
          "type": "number"
        },
        "model": {
          "type": "string"
        },
        "structured_output_strategy": {
          "type": "string"
        },
        "temperature": {
          "format": "float",
          "type": "number"
        },
        "use_native_tools": {
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "messages": {
      "items": {
        "properties": {
          "content": {
            "items": {
              "properties": {
                "artifact": {
                  "properties": {
                    "id": {
                      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                      "type": "string"
                    },
                    "meta": {},
                    "name": {
                      "type": "string"
                    },
                    "reference": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    },
                    "value": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "type",
                    "value"
                  ],
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "artifact",
                "type"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "role": {
            "type": "string"
          },
          "usage": {
            "properties": {
              "input_tokens": {
                "type": "number"
              },
              "output_tokens": {
                "type": "number"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "input_tokens",
              "output_tokens",
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "content",
          "role",
          "usage"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "output_schema": {
      "properties": {
        "additionalProperties": {
          "type": "boolean"
        },
        "description": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "properties": {
          "properties": {
            "member": {
              "properties": {
                "additionalProperties": {
                  "type": "boolean"
                },
                "description": {
                  "type": "string"
                },
                "properties": "[Circular]",
                "required": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "additionalProperties",
                "description",
                "properties",
                "required",
                "type"
              ],
              "type": "object"
            }
          },
          "type": "object"
        },
        "required": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "schema": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "additionalProperties",
        "description",
        "id",
        "properties",
        "required",
        "schema",
        "title",
        "type"
      ],
      "type": "object"
    },
    "tools": {
      "items": {
        "properties": {
          "activities": {
            "items": {
              "properties": {
                "description": {
                  "type": "string"
                },
                "json_schema": {
                  "properties": {
                    "additionalProperties": {
                      "type": "boolean"
                    },
                    "description": {
                      "type": "string"
                    },
                    "id": {
                      "type": "string"
                    },
                    "properties": {
                      "properties": {
                        "member": {
                          "properties": {
                            "additionalProperties": {
                              "type": "boolean"
                            },
                            "description": {
                              "type": "string"
                            },
                            "properties": "[Circular]",
                            "required": {
                              "items": {
                                "type": "string"
                              },
                              "type": "array"
                            },
                            "type": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "additionalProperties",
                            "description",
                            "properties",
                            "required",
                            "type"
                          ],
                          "type": "object"
                        }
                      },
                      "type": "object"
                    },
                    "required": {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "schema": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "additionalProperties",
                    "description",
                    "id",
                    "properties",
                    "required",
                    "schema",
                    "title",
                    "type"
                  ],
                  "type": "object"
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "description",
                "json_schema",
                "name"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "activities",
          "name"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "driver_configuration",
    "messages",
    "output_schema",
    "tools"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
driver_configurationChatMessageDriverConfigurationtruenonenone
messages[ChatMessageMessage]truenonenone
output_schemaJsonSchematruenonenone
tools[ChatMessageTool]truenonenone

CreateChatMessageStreamResponseContent

{
  "properties": {
    "content": {
      "items": {
        "properties": {
          "artifact": {
            "properties": {
              "id": {
                "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                "type": "string"
              },
              "meta": {},
              "name": {
                "type": "string"
              },
              "reference": {
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "name",
              "type",
              "value"
            ],
            "type": "object"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "artifact",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "role": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "usage": {
      "properties": {
        "input_tokens": {
          "type": "number"
        },
        "output_tokens": {
          "type": "number"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "input_tokens",
        "output_tokens",
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "content",
    "role",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
content[StreamMessageContent]truenonenone
rolestringtruenonenone
typestringtruenonenone
usageChatMessageUsagefalsenonenone

CreateCheckoutSessionRequestContent

{
  "properties": {
    "price_lookup_key": {
      "type": "string"
    }
  },
  "required": [
    "price_lookup_key"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
price_lookup_keystringtruenonenone

CreateCheckoutSessionResponseContent

{
  "properties": {
    "redirect_url": {
      "type": "string"
    }
  },
  "required": [
    "redirect_url"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
redirect_urlstringtruenonenone

CreateConnectionRequestContent

{
  "properties": {
    "credentials": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "auth_code": {
                  "type": "string"
                }
              },
              "required": [
                "auth_code"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        }
      ]
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "type": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "credentials",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
credentialsConnectionCredentialsInputtruenonenone
namestringfalsenonenone
typestringtruenonenone

CreateConnectionResponseContent

{
  "properties": {
    "connection_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "connection_id",
    "created_at",
    "created_by",
    "name",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
connection_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
namestringtruenonenone
typestringtruenonenone

CreateDataConnectorRequestContent

{
  "properties": {
    "config": {
      "oneOf": [
        {
          "properties": {
            "confluence": {
              "properties": {
                "atlassian_api_token": {
                  "type": "string"
                },
                "atlassian_email": {
                  "type": "string"
                },
                "domain": {
                  "type": "string"
                }
              },
              "required": [
                "atlassian_api_token",
                "atlassian_email",
                "domain"
              ],
              "type": "object"
            }
          },
          "required": [
            "confluence"
          ],
          "title": "confluence",
          "type": "object"
        },
        {
          "properties": {
            "google_drive": {
              "properties": {
                "auth_code": {
                  "type": "string"
                },
                "file_ids": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "auth_code",
                "file_ids"
              ],
              "type": "object"
            }
          },
          "required": [
            "google_drive"
          ],
          "title": "google_drive",
          "type": "object"
        },
        {
          "properties": {
            "webscraper": {
              "properties": {
                "urls": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "urls"
              ],
              "type": "object"
            }
          },
          "required": [
            "webscraper"
          ],
          "title": "webscraper",
          "type": "object"
        },
        {
          "properties": {
            "structure": {
              "properties": {
                "args": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "structure_id": {
                  "type": "string"
                }
              },
              "required": [
                "structure_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "structure"
          ],
          "title": "structure",
          "type": "object"
        },
        {
          "properties": {
            "s3": {
              "properties": {
                "aws_access_key_id": {
                  "type": "string"
                },
                "aws_secret_access_key": {
                  "type": "string"
                },
                "uris": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "aws_access_key_id",
                "aws_secret_access_key",
                "uris"
              ],
              "type": "object"
            }
          },
          "required": [
            "s3"
          ],
          "title": "s3",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_paths": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "bucket_id": {
                  "type": "string"
                }
              },
              "required": [
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        }
      ]
    },
    "description": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "schedule_expression": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "transforms": {
      "items": {
        "properties": {
          "structure": {
            "properties": {
              "args": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "structure_id": {
                "type": "string"
              }
            },
            "required": [
              "structure_id"
            ],
            "type": "object"
          }
        },
        "required": [
          "structure"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "type": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "config",
    "name",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
configDataConnectorConfigInputUniontruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
schedule_expressionstringfalsenonenone
transforms[TransformInput]falsenonenone
typestringtruenonenone

CreateDataConnectorResponseContent

{
  "properties": {
    "config": {
      "oneOf": [
        {
          "properties": {
            "confluence": {
              "properties": {
                "atlassian_email": {
                  "type": "string"
                },
                "domain": {
                  "type": "string"
                }
              },
              "required": [
                "atlassian_email",
                "domain"
              ],
              "type": "object"
            }
          },
          "required": [
            "confluence"
          ],
          "title": "confluence",
          "type": "object"
        },
        {
          "properties": {
            "google_drive": {
              "properties": {
                "access_token": {
                  "type": "string"
                },
                "file_ids": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "access_token",
                "file_ids"
              ],
              "type": "object"
            }
          },
          "required": [
            "google_drive"
          ],
          "title": "google_drive",
          "type": "object"
        },
        {
          "properties": {
            "webscraper": {
              "properties": {
                "urls": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "urls"
              ],
              "type": "object"
            }
          },
          "required": [
            "webscraper"
          ],
          "title": "webscraper",
          "type": "object"
        },
        {
          "properties": {
            "structure": {
              "properties": {
                "args": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "structure_id": {
                  "type": "string"
                }
              },
              "required": [
                "structure_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "structure"
          ],
          "title": "structure",
          "type": "object"
        },
        {
          "properties": {
            "s3": {
              "properties": {
                "aws_access_key_id": {
                  "type": "string"
                },
                "uris": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "aws_access_key_id",
                "uris"
              ],
              "type": "object"
            }
          },
          "required": [
            "s3"
          ],
          "title": "s3",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_paths": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "bucket_id": {
                  "type": "string"
                }
              },
              "required": [
                "asset_paths",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        }
      ]
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "data_connector_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "data_job_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "schedule_expression": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "config",
    "created_at",
    "created_by",
    "data_connector_id",
    "name",
    "type",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
configDataConnectorConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_idstringtruenonenone
data_job_idstringfalsenonenone
descriptionstringfalsenonenone
namestringtruenonenone
schedule_expressionstringfalsenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone

CreateDataJobResponseContent

{
  "properties": {
    "bytes_ingested": {
      "type": "number"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "data_connector_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "data_job_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "errors": {
      "items": {
        "properties": {
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "message",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "status": {
      "enum": [
        "QUEUED",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {}
  },
  "required": [
    "created_at",
    "created_by",
    "data_connector_id",
    "data_job_id",
    "status"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bytes_ingestednumberfalsenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_idstringtruenonenone
data_job_idstringtruenonenone
errors[Error]falsenonenone
statusDataJobStatustruenonenone
status_detailanyfalsenonenone

CreateEventsRequestContent

{
  "properties": {
    "events": {
      "items": {
        "properties": {
          "payload": {},
          "timestamp": {
            "format": "double",
            "type": "number"
          },
          "type": {
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "timestamp",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
events[EventInput]falsenonenone

CreateFunctionDeploymentRequestContent

{
  "properties": {
    "code_source": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "access_token": {
                  "maxLength": 1000,
                  "minLength": 1,
                  "type": "string"
                },
                "commit_sha": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                }
              },
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        }
      ]
    },
    "force": {
      "type": "boolean"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
code_sourceCodeSourceInputfalsenonenone
forcebooleanfalsenonenone

CreateFunctionDeploymentResponseContent

{
  "properties": {
    "code_source": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "commit_sha": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                }
              },
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        }
      ]
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "function_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "status": {
      "enum": [
        "QUEUED",
        "DEPLOYING",
        "SUCCEEDED",
        "FAILED",
        "ERROR"
      ],
      "type": "string"
    },
    "status_detail": {}
  },
  "required": [
    "code_source",
    "created_at",
    "created_by",
    "deployment_id",
    "function_id",
    "status"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
code_sourceCodeSourcetruenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringtruenonenone
function_idstringtruenonenone
statusDeploymentStatustruenonenone
status_detailanyfalsenonenone

CreateFunctionExecutionGetOutputPayload

{}

Properties

None

CreateFunctionExecutionPostInputPayload

{}

Properties

None

CreateFunctionExecutionPostOutputPayload

{}

Properties

None

CreateFunctionRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeFunctionCodefalsenonenone
descriptionstringfalsenonenone
env_vars[EnvVar]falsenonenone
function_config_filestringfalsenonenone
namestringtruenonenone

CreateFunctionResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeFunctionCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
function_config_filestringfalsenonenone
function_idstringtruenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateIntegrationRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_ids[string]falsenonenone
configIntegrationConfigInputUniontruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
structure_ids[string]falsenonenone
typeIntegrationTypetruenonenone

CreateIntegrationResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_ids[string]truenonenone
configIntegrationConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
integration_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
structure_ids[string]truenonenone
typeIntegrationTypetruenonenone
updated_atstring(date-time)truenonenone

CreateInviteRequestContent

{
  "properties": {
    "email": {
      "maxLength": 254,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "email"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
emailstringtruenonenone

CreateInviteResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
emailstringtruenonenone
expires_atstring(date-time)truenonenone
invite_idstringtruenonenone
organization_idstringtruenonenone
responded_atstring(date-time)falsenonenone
statusInviteStatustruenonenone

CreateKnowledgeBaseJobResponseContent

{
  "properties": {
    "bytes_ingested": {
      "type": "number"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "errors": {
      "items": {
        "properties": {
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "message",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "knowledge_base_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "knowledge_base_job_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "status": {
      "enum": [
        "QUEUED",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {}
  },
  "required": [
    "created_at",
    "created_by",
    "knowledge_base_id",
    "knowledge_base_job_id",
    "status"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bytes_ingestednumberfalsenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
errors[Error]falsenonenone
knowledge_base_idstringtruenonenone
knowledge_base_job_idstringtruenonenone
statusKnowledgeBaseJobStatustruenonenone
status_detailanyfalsenonenone

CreateKnowledgeBaseRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_paths[string]falsenonenone
configKnowledgeBaseConfigInputUniontruenonenone
descriptionstringfalsenonenone
embedding_modelEmbeddingModelfalsenonenone
namestringtruenonenone
transforms[TransformDetail]falsenonenone
typestringtruenonenone
use_default_embedding_modelbooleanfalsenonenone

CreateKnowledgeBaseResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_paths[string]truenonenone
configKnowledgeBaseConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
embedding_modelEmbeddingModelfalsenonenone
knowledge_base_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
schedule_expressionstringfalsenonenone
transforms[TransformDetail]falsenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone
use_default_embedding_modelbooleanfalsenonenone

CreateLibraryRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
data_connector_ids[string]truenonenone
descriptionstringfalsenonenone
knowledge_base_configs[KnowledgeBaseConfigInputUnion]truenonenone
namestringtruenonenone

CreateLibraryResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_ids[string]truenonenone
descriptionstringfalsenonenone
knowledge_base_ids[string]truenonenone
library_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateMessageRequestContent

{
  "properties": {
    "input": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "output": {
      "type": "string"
    }
  },
  "required": [
    "input",
    "output"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
inputstringtruenonenone
metadataMetadatafalsenonenone
outputstringtruenonenone

CreateMessageResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
indexnumbertruenonenone
inputstringtruenonenone
message_idstringtruenonenone
metadataMetadatatruenonenone
outputstringtruenonenone
thread_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateOrganizationApiKeyRequestContent

{
  "properties": {
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringtruenonenone

CreateOrganizationApiKeyResponseContent

{
  "properties": {
    "active": {
      "type": "boolean"
    },
    "api_key_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    },
    "value": {
      "type": "string"
    }
  },
  "required": [
    "active",
    "api_key_id",
    "created_at",
    "created_by",
    "last_used",
    "name",
    "organization_id",
    "updated_at",
    "value"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
activebooleantruenonenone
api_key_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
last_usedstring(date-time)truenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone
valuestringtruenonenone

CreateOrganizationRequestContent

{
  "properties": {
    "description": {
      "maxLength": 2000,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
descriptionstringfalsenonenone
namestringtruenonenone

CreateOrganizationResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
default_bucket_idstringtruenonenone
descriptionstringtruenonenone
entitlementanytruenonenone

allOf

NameTypeRequiredRestrictionsDescription
» anonymousEntitlementfalsenonenone

and

NameTypeRequiredRestrictionsDescription
» anonymousanyfalsenonenone

continued

NameTypeRequiredRestrictionsDescription
model_configOrganizationModelConfigfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateRetrieverComponentRequestContent

{
  "properties": {
    "config": {},
    "description": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "config",
    "name",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
configanytruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
typestringtruenonenone

CreateRetrieverComponentResponseContent

{
  "properties": {
    "config": {},
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_component_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "config",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_component_id",
    "type",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
configanytruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_component_idstringtruenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone

CreateRetrieverRequestContent

{
  "properties": {
    "description": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    },
    "retriever_component_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "description": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "name": {
            "maxLength": 64,
            "minLength": 1,
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
descriptionstringfalsenonenone
namestringtruenonenone
retriever_component_ids[string]falsenonenone
retriever_components[RetrieverComponentInput]falsenonenone

CreateRetrieverResponseContent

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_component_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "config",
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_component_id",
          "type",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "retriever_components_schema": {},
    "retriever_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_components",
    "retriever_components_schema",
    "retriever_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_components[RetrieverComponentDetail]truenonenone
retriever_components_schemaanytruenonenone
retriever_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateRuleRequestContent

{
  "properties": {
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "rule": {
      "maxLength": 2000,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name",
    "rule"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
metadataMetadatafalsenonenone
namestringtruenonenone
rulestringtruenonenone

CreateRuleResponseContent

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule": {
      "type": "string"
    },
    "rule_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "rule",
    "rule_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
rulestringtruenonenone
rule_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateRulesetRequestContent

{
  "properties": {
    "alias": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "description": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringfalsenonenone
descriptionstringfalsenonenone
metadataMetadatafalsenonenone
namestringtruenonenone
rule_ids[string]falsenonenone

CreateRulesetResponseContent

{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "description",
    "metadata",
    "name",
    "organization_id",
    "rule_ids",
    "ruleset_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
rule_ids[string]truenonenone
ruleset_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateSecretRequestContent

{
  "properties": {
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "value": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name",
    "value"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringtruenonenone
valuestringtruenonenone

CreateSecretResponseContent

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "secret_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "last_used",
    "name",
    "organization_id",
    "secret_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
last_usedstring(date-time)truenonenone
namestringtruenonenone
organization_idstringtruenonenone
secret_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateStructureDeploymentRequestContent

{
  "properties": {
    "code_source": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "access_token": {
                  "maxLength": 1000,
                  "minLength": 1,
                  "type": "string"
                },
                "commit_sha": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                }
              },
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        }
      ]
    },
    "force": {
      "type": "boolean"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
code_sourceCodeSourceInputfalsenonenone
forcebooleanfalsenonenone

CreateStructureDeploymentResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
code_sourceCodeSourcetruenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringtruenonenone
statusDeploymentStatustruenonenone
status_detailanyfalsenonenone
structure_idstringtruenonenone

CreateStructureRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeStructureCodefalsenonenone
descriptionstringfalsenonenone
env_vars[EnvVar]falsenonenone
namestringtruenonenone
structure_config_filestringfalsenonenone
webhook_enabledbooleanfalsenonenone

CreateStructureResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeStructureCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
structure_config_filestringfalsenonenone
structure_idstringtruenonenone
updated_atstring(date-time)truenonenone
webhook_enabledbooleantruenonenone

CreateStructureRunRequestContent

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "args"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]truenonenone
env_vars[EnvVar]falsenonenone

CreateStructureRunResponseContent

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "output": {},
    "output_timestamp": {
      "format": "double",
      "type": "number"
    },
    "started_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "structure_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "structure_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "completed_at",
    "created_at",
    "created_by",
    "started_at",
    "status",
    "structure_id",
    "structure_run_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]truenonenone
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringfalsenonenone
env_vars[EnvVar]falsenonenone
outputanyfalsenonenone
output_timestampnumber(double)falsenonenone
started_atstring(date-time)¦nulltruenonenone
statusStructureRunStatustruenonenone
status_detailanyfalsenonenone
structure_idstringtruenonenone
structure_run_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateThreadRequestContent

{
  "properties": {
    "alias": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "messages": {
      "items": {
        "properties": {
          "input": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "output": {
            "type": "string"
          }
        },
        "required": [
          "input",
          "output"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringfalsenonenone
messages[MessageInput]falsenonenone
metadataMetadatafalsenonenone
namestringtruenonenone

CreateThreadResponseContent

{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "thread_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
thread_idstringtruenonenone
updated_atstring(date-time)truenonenone

CreateToolActivityRunInputPayload

{}

Properties

None

CreateToolActivityRunOutputPayload

{}

Properties

None

CreateToolDeploymentRequestContent

{
  "properties": {
    "code_source": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "access_token": {
                  "maxLength": 1000,
                  "minLength": 1,
                  "type": "string"
                },
                "commit_sha": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                }
              },
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        }
      ]
    },
    "force": {
      "type": "boolean"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
code_sourceCodeSourceInputfalsenonenone
forcebooleanfalsenonenone

CreateToolDeploymentResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
code_sourceCodeSourcetruenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringtruenonenone
statusDeploymentStatustruenonenone
status_detailanyfalsenonenone
tool_idstringtruenonenone

CreateToolRequestContent

{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "description": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "tool_config_file": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
codeToolCodefalsenonenone
descriptionstringfalsenonenone
env_vars[EnvVar]falsenonenone
namestringtruenonenone
tool_config_filestringfalsenonenone

CreateToolResponseContent

{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "latest_deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_config_file": {
      "type": "string"
    },
    "tool_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "code",
    "created_at",
    "created_by",
    "description",
    "env_vars",
    "latest_deployment_id",
    "name",
    "organization_id",
    "tool_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
codeToolCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
tool_config_filestringfalsenonenone
tool_idstringtruenonenone
updated_atstring(date-time)truenonenone

DataConnectorConfigInputUnion

{
  "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"
    }
  ]
}

Properties

oneOf

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» confluenceConfluenceInputtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» google_driveGoogleDriveInputtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» webscraperWebscraperInputtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» structureStructureConnectorInputtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» s3S3ConnectorInputtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» data_lakeDataLakeConnectorInputtruenonenone

DataConnectorConfigUnion

{
  "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"
    }
  ]
}

Properties

oneOf

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» confluenceConfluenceDetailtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» google_driveGoogleDriveDetailtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» webscraperWebscraperDetailtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» structureStructureConnectorDetailtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» s3S3ConnectorDetailtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» data_lakeDataLakeConnectorDetailtruenonenone

DataConnectorDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
bucket_idstringfalsenonenone
configDataConnectorConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_idstringtruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
schedule_expressionstringfalsenonenone
transforms[TransformDetail]falsenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone

DataJobDetail

{
  "properties": {
    "bytes_ingested": {
      "type": "number"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "data_connector_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "data_job_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "errors": {
      "items": {
        "properties": {
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "message",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "status": {
      "enum": [
        "QUEUED",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {}
  },
  "required": [
    "created_at",
    "created_by",
    "data_connector_id",
    "data_job_id",
    "status"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bytes_ingestednumberfalsenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_idstringtruenonenone
data_job_idstringtruenonenone
errors[Error]falsenonenone
statusDataJobStatustruenonenone
status_detailanyfalsenonenone

DataJobStatus

{
  "enum": [
    "QUEUED",
    "RUNNING",
    "SUCCEEDED",
    "FAILED",
    "CANCELLED"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousQUEUED
anonymousRUNNING
anonymousSUCCEEDED
anonymousFAILED
anonymousCANCELLED

DataLakeCodeSource

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_pathstringtruenonenone
bucket_idstringtruenonenone

DataLakeConnectorDetail

{
  "properties": {
    "asset_paths": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "bucket_id": {
      "type": "string"
    }
  },
  "required": [
    "asset_paths",
    "bucket_id"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_paths[string]truenonenone
bucket_idstringtruenonenone

DataLakeConnectorInput

{
  "properties": {
    "asset_paths": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "bucket_id": {
      "type": "string"
    }
  },
  "required": [
    "bucket_id"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_paths[string]falsenonenone
bucket_idstringtruenonenone

DataLakeFunctionCode

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_pathstringtruenonenone
bucket_idstringtruenonenone

DataLakeStructureCode

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_pathstringtruenonenone
bucket_idstringtruenonenone

DataLakeToolCode

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_pathstringtruenonenone
bucket_idstringtruenonenone

DefaultFunctionCode

{
  "type": "object"
}

Properties

None

DefaultStructureCode

{
  "type": "object"
}

Properties

None

DefaultToolCode

{
  "type": "object"
}

Properties

None

DeploymentCountGauge

{
  "properties": {
    "active_count": {
      "type": "number"
    },
    "total_count": {
      "type": "number"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
active_countnumberfalsenonenone
total_countnumberfalsenonenone

DeploymentDurationGauge

{
  "properties": {
    "total_seconds": {
      "type": "number"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
total_secondsnumberfalsenonenone

DeploymentErrorRateGauge

{
  "properties": {
    "rate": {
      "format": "float",
      "type": "number"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
ratenumber(float)falsenonenone

DeploymentStatus

{
  "enum": [
    "QUEUED",
    "DEPLOYING",
    "SUCCEEDED",
    "FAILED",
    "ERROR"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousQUEUED
anonymousDEPLOYING
anonymousSUCCEEDED
anonymousFAILED
anonymousERROR

DurationPlot

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
seconds_avgnumberfalsenonenone
seconds_p100numberfalsenonenone
seconds_p50numberfalsenonenone
timeseries[DurationTimeseriesElement]falsenonenone

DurationTimeseriesElement

{
  "properties": {
    "seconds_p0": {
      "type": "number"
    },
    "seconds_p100": {
      "type": "number"
    },
    "seconds_p50": {
      "type": "number"
    },
    "time": {
      "format": "date-time",
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
seconds_p0numberfalsenonenone
seconds_p100numberfalsenonenone
seconds_p50numberfalsenonenone
timestring(date-time)falsenonenone

EmbeddingModel

{
  "enum": [
    "text-embedding-ada-002",
    "text-embedding-3-small"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymoustext-embedding-ada-002
anonymoustext-embedding-3-small

Entitlement

{
  "enum": [
    "FREE",
    "PAID",
    "PARTNER",
    "UNPAID",
    "EXPIRED"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousFREE
anonymousPAID
anonymousPARTNER
anonymousUNPAID
anonymousEXPIRED

Entry

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
idstringtruenonenone
metaMetafalsenonenone
namespacestringfalsenonenone
scorenumber(float)truenonenone
vector[number]falsenonenone

EnvVar

{
  "properties": {
    "name": {
      "type": "string"
    },
    "source": {
      "enum": [
        "secret_ref",
        "manual"
      ],
      "type": "string"
    },
    "value": {
      "type": "string"
    }
  },
  "required": [
    "name",
    "value"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringtruenonenone
sourceEnvVarSourcefalsenonenone
valuestringtruenonenone

EnvVarSource

{
  "enum": [
    "secret_ref",
    "manual"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymoussecret_ref
anonymousmanual

Error

{
  "properties": {
    "message": {
      "type": "string"
    },
    "path": {
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "message",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
messagestringtruenonenone
pathstringfalsenonenone
typestringtruenonenone

ErrorRateGauge

{
  "properties": {
    "error_type_counts": {
      "items": {
        "properties": {
          "count": {
            "type": "number"
          },
          "error_type": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "rate": {
      "format": "float",
      "type": "number"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
error_type_counts[ErrorTypeCount]falsenonenone
ratenumber(float)falsenonenone

ErrorTypeCount

{
  "properties": {
    "count": {
      "type": "number"
    },
    "error_type": {
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
countnumberfalsenonenone
error_typestringfalsenonenone

EventDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
event_idstringtruenonenone
originstringtruenonenone
payloadanytruenonenone
structure_run_idstringtruenonenone
timestampnumber(double)truenonenone
typestringtruenonenone

EventInput

{
  "properties": {
    "payload": {},
    "timestamp": {
      "format": "double",
      "type": "number"
    },
    "type": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "timestamp",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
payloadanyfalsenonenone
timestampnumber(double)truenonenone
typestringtruenonenone

FunctionCode

{
  "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"
    }
  ]
}

Properties

oneOf

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» githubGithubFunctionCodetruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» data_lakeDataLakeFunctionCodetruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» defaultDefaultFunctionCodetruenonenone

FunctionDeploymentDetail

{
  "properties": {
    "code_source": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "commit_sha": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                }
              },
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        }
      ]
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "function_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "status": {
      "enum": [
        "QUEUED",
        "DEPLOYING",
        "SUCCEEDED",
        "FAILED",
        "ERROR"
      ],
      "type": "string"
    },
    "status_detail": {}
  },
  "required": [
    "code_source",
    "created_at",
    "created_by",
    "deployment_id",
    "function_id",
    "status"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
code_sourceCodeSourcetruenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringtruenonenone
function_idstringtruenonenone
statusDeploymentStatustruenonenone
status_detailanyfalsenonenone

FunctionDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeFunctionCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
function_config_filestringfalsenonenone
function_idstringtruenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

FunctionRunDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringfalsenonenone
env_vars[EnvVar]falsenonenone
function_idstringtruenonenone
function_run_idstringtruenonenone
inputanytruenonenone
outputanyfalsenonenone
output_timestampnumber(double)falsenonenone
runtime_pathstringtruenonenone
started_atstring(date-time)¦nulltruenonenone
statusFunctionRunStatustruenonenone
status_detailanyfalsenonenone
updated_atstring(date-time)truenonenone

FunctionRunStatus

{
  "enum": [
    "QUEUED",
    "STARTING",
    "RUNNING",
    "SUCCEEDED",
    "FAILED",
    "ERROR",
    "CANCELLED"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousQUEUED
anonymousSTARTING
anonymousRUNNING
anonymousSUCCEEDED
anonymousFAILED
anonymousERROR
anonymousCANCELLED

GTCHybidSQLPGVectorKnowledgeBaseDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
embedding_modelstringtruenonenone
query_schemaanytruenonenone
structured_columns[StructuredColumnDetail]truenonenone
unstructured_columns[UnstructuredColumnDetail]truenonenone
use_default_embedding_modelbooleantruenonenone

GTCHybidSQLPGVectorKnowledgeBaseInput

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
embedding_modelstringfalsenonenone
structured_columns[StructuredColumnInput]truenonenone
unstructured_columns[UnstructuredColumnInput]truenonenone
use_default_embedding_modelbooleanfalsenonenone

GTCPGVectorKnowledgeBaseDetail

{
  "properties": {
    "embedding_model": {
      "type": "string"
    },
    "query_schema": {},
    "use_default_embedding_model": {
      "type": "boolean"
    }
  },
  "required": [
    "embedding_model",
    "query_schema",
    "use_default_embedding_model"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
embedding_modelstringtruenonenone
query_schemaanytruenonenone
use_default_embedding_modelbooleantruenonenone

GTCPGVectorKnowledgeBaseInput

{
  "properties": {
    "embedding_model": {
      "type": "string"
    },
    "use_default_embedding_model": {
      "type": "boolean"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
embedding_modelstringfalsenonenone
use_default_embedding_modelbooleanfalsenonenone

GetApiKeyResponseContent

{
  "properties": {
    "active": {
      "type": "boolean"
    },
    "api_key_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "active",
    "api_key_id",
    "created_at",
    "created_by",
    "last_used",
    "name",
    "organization_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
activebooleantruenonenone
api_key_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
last_usedstring(date-time)truenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetAssetResponseContent

{
  "properties": {
    "bucket_id": {
      "type": "string"
    },
    "contents": {},
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "size": {
      "type": "number"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bucket_idstringfalsenonenone
contentsanyfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
sizenumberfalsenonenone
updated_atstring(date-time)truenonenone

GetAssistantResponseContent

{
  "properties": {
    "assistant_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "assistant_id",
    "created_at",
    "created_by",
    "description",
    "knowledge_base_ids",
    "name",
    "organization_id",
    "retriever_ids",
    "ruleset_ids",
    "structure_ids",
    "tool_ids",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
inputstringfalsenonenone
knowledge_base_ids[string]truenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_ids[string]truenonenone
ruleset_ids[string]truenonenone
structure_ids[string]truenonenone
tool_ids[string]truenonenone
updated_atstring(date-time)truenonenone

GetAssistantRunEventsSSEOutputPayload

{
  "format": "byte",
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstring(byte)falsenonenone

GetAssistantRunResponseContent

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "assistant_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "assistant_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "output": {},
    "retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "stream": {
      "type": "boolean"
    },
    "structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "assistant_id",
    "assistant_run_id",
    "completed_at",
    "created_at",
    "created_by",
    "knowledge_base_ids",
    "retriever_ids",
    "ruleset_ids",
    "status",
    "stream",
    "structure_ids",
    "tool_ids",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]truenonenone
assistant_idstringtruenonenone
assistant_run_idstringtruenonenone
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
inputstringfalsenonenone
knowledge_base_ids[string]truenonenone
outputanyfalsenonenone
retriever_ids[string]truenonenone
ruleset_ids[string]truenonenone
statusAssistantRunStatustruenonenone
status_detailanyfalsenonenone
streambooleantruenonenone
structure_ids[string]truenonenone
thread_idstringfalsenonenone
tool_ids[string]truenonenone
updated_atstring(date-time)truenonenone

GetBucketResponseContent

{
  "properties": {
    "bucket_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "bucket_id",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bucket_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetConfigResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
data_lake_s3_bucketstringtruenonenone
data_lake_s3_regionstringtruenonenone
data_lake_s3_urlstringtruenonenone
google_drive_data_connector_client_idstringtruenonenone

GetDataConnectorResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
bucket_idstringfalsenonenone
configDataConnectorConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_idstringtruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
schedule_expressionstringfalsenonenone
transforms[TransformDetail]falsenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone

GetDataJobResponseContent

{
  "properties": {
    "bytes_ingested": {
      "type": "number"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "data_connector_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "data_job_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "errors": {
      "items": {
        "properties": {
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "message",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "status": {
      "enum": [
        "QUEUED",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {}
  },
  "required": [
    "created_at",
    "created_by",
    "data_connector_id",
    "data_job_id",
    "status"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bytes_ingestednumberfalsenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_idstringtruenonenone
data_job_idstringtruenonenone
errors[Error]falsenonenone
statusDataJobStatustruenonenone
status_detailanyfalsenonenone

GetDeploymentResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
code_sourceCodeSourcetruenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringtruenonenone
function_idstringfalsenonenone
statusDeploymentStatustruenonenone
status_detailanyfalsenonenone
structure_idstringfalsenonenone
tool_idstringfalsenonenone

GetEventResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
event_idstringtruenonenone
originstringtruenonenone
payloadanytruenonenone
structure_run_idstringtruenonenone
timestampnumber(double)truenonenone
typestringtruenonenone

GetFunctionResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeFunctionCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
function_config_filestringfalsenonenone
function_idstringtruenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetFunctionRunResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringfalsenonenone
env_vars[EnvVar]falsenonenone
function_idstringtruenonenone
function_run_idstringtruenonenone
inputanytruenonenone
outputanyfalsenonenone
output_timestampnumber(double)falsenonenone
runtime_pathstringtruenonenone
started_atstring(date-time)¦nulltruenonenone
statusFunctionRunStatustruenonenone
status_detailanyfalsenonenone
updated_atstring(date-time)truenonenone

GetIntegrationResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_ids[string]truenonenone
configIntegrationConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
integration_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
structure_ids[string]truenonenone
typeIntegrationTypetruenonenone
updated_atstring(date-time)truenonenone

GetInviteResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
emailstringtruenonenone
expires_atstring(date-time)truenonenone
invite_idstringtruenonenone
organization_idstringtruenonenone
responded_atstring(date-time)falsenonenone
statusInviteStatustruenonenone

GetKnowledgeBaseJobResponseContent

{
  "properties": {
    "bytes_ingested": {
      "type": "number"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "errors": {
      "items": {
        "properties": {
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "message",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "knowledge_base_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "knowledge_base_job_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "status": {
      "enum": [
        "QUEUED",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {}
  },
  "required": [
    "created_at",
    "created_by",
    "knowledge_base_id",
    "knowledge_base_job_id",
    "status"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bytes_ingestednumberfalsenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
errors[Error]falsenonenone
knowledge_base_idstringtruenonenone
knowledge_base_job_idstringtruenonenone
statusKnowledgeBaseJobStatustruenonenone
status_detailanyfalsenonenone

GetKnowledgeBaseQueryResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
entries[Entry]truenonenone
knowledge_base_idstringtruenonenone
knowledge_base_query_idstringtruenonenone
querystringtruenonenone

GetKnowledgeBaseResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_paths[string]truenonenone
configKnowledgeBaseConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
embedding_modelEmbeddingModelfalsenonenone
knowledge_base_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
schedule_expressionstringfalsenonenone
transforms[TransformDetail]falsenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone
use_default_embedding_modelbooleanfalsenonenone

GetKnowledgeBaseSearchResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
knowledge_base_idstringtruenonenone
knowledge_base_search_idstringtruenonenone
querystringtruenonenone
resultstringtruenonenone

GetLibraryResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_ids[string]truenonenone
descriptionstringfalsenonenone
knowledge_base_ids[string]truenonenone
library_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetMessageResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
indexnumbertruenonenone
inputstringtruenonenone
message_idstringtruenonenone
metadataMetadatatruenonenone
outputstringtruenonenone
thread_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetOrganizationResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
default_bucket_idstringtruenonenone
descriptionstringtruenonenone
entitlementanytruenonenone

allOf

NameTypeRequiredRestrictionsDescription
» anonymousEntitlementfalsenonenone

and

NameTypeRequiredRestrictionsDescription
» anonymousanyfalsenonenone

continued

NameTypeRequiredRestrictionsDescription
model_configOrganizationModelConfigfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetRetrieverComponentResponseContent

{
  "properties": {
    "config": {},
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_component_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "config",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_component_id",
    "type",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
configanytruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_component_idstringtruenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone

GetRetrieverResponseContent

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_component_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "config",
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_component_id",
          "type",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "retriever_components_schema": {},
    "retriever_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_components",
    "retriever_components_schema",
    "retriever_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_components[RetrieverComponentDetail]truenonenone
retriever_components_schemaanytruenonenone
retriever_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetRuleResponseContent

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule": {
      "type": "string"
    },
    "rule_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "rule",
    "rule_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
rulestringtruenonenone
rule_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetRulesetResponseContent

{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "description",
    "metadata",
    "name",
    "organization_id",
    "rule_ids",
    "ruleset_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
rule_ids[string]truenonenone
ruleset_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetSecretResponseContent

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "secret_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "last_used",
    "name",
    "organization_id",
    "secret_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
last_usedstring(date-time)truenonenone
namestringtruenonenone
organization_idstringtruenonenone
secret_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetStructureResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeStructureCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
structure_config_filestringfalsenonenone
structure_idstringtruenonenone
updated_atstring(date-time)truenonenone
webhook_enabledbooleantruenonenone

GetStructureRunEventsSSEOutputPayload

{
  "format": "byte",
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstring(byte)falsenonenone

GetStructureRunResponseContent

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "output": {},
    "output_timestamp": {
      "format": "double",
      "type": "number"
    },
    "started_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "structure_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "structure_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "completed_at",
    "created_at",
    "created_by",
    "started_at",
    "status",
    "structure_id",
    "structure_run_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]truenonenone
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringfalsenonenone
env_vars[EnvVar]falsenonenone
outputanyfalsenonenone
output_timestampnumber(double)falsenonenone
started_atstring(date-time)¦nulltruenonenone
statusStructureRunStatustruenonenone
status_detailanyfalsenonenone
structure_idstringtruenonenone
structure_run_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetStructuresDashboardResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
deployment_count_gaugeDeploymentCountGaugefalsenonenone
deployment_duration_gaugeDeploymentDurationGaugefalsenonenone
deployment_error_rate_gaugeDeploymentErrorRateGaugefalsenonenone
duration_plotDurationPlotfalsenonenone
error_rate_gaugeErrorRateGaugefalsenonenone
run_count_gaugeRunCountGaugefalsenonenone
run_duration_gaugeRunDurationGaugefalsenonenone
token_count_gaugeTokenCountGaugefalsenonenone

GetThreadResponseContent

{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "thread_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
thread_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetTokenResponseContent

{
  "properties": {
    "access_token": {
      "type": "string"
    }
  },
  "required": [
    "access_token"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
access_tokenstringtruenonenone

GetToolOpenApiRunOutputPayload

{}

Properties

None

GetToolResponseContent

{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "latest_deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_config_file": {
      "type": "string"
    },
    "tool_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "code",
    "created_at",
    "created_by",
    "description",
    "env_vars",
    "latest_deployment_id",
    "name",
    "organization_id",
    "tool_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
codeToolCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
tool_config_filestringfalsenonenone
tool_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetToolRunResponseContent

{
  "properties": {
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "input": {},
    "output": {},
    "output_timestamp": {
      "format": "double",
      "type": "number"
    },
    "runtime_path": {
      "type": "string"
    },
    "started_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "tool_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "completed_at",
    "created_at",
    "created_by",
    "input",
    "runtime_path",
    "started_at",
    "status",
    "tool_id",
    "tool_run_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringfalsenonenone
env_vars[EnvVar]falsenonenone
inputanytruenonenone
outputanyfalsenonenone
output_timestampnumber(double)falsenonenone
runtime_pathstringtruenonenone
started_atstring(date-time)¦nulltruenonenone
statusToolRunStatustruenonenone
status_detailanyfalsenonenone
tool_idstringtruenonenone
tool_run_idstringtruenonenone
updated_atstring(date-time)truenonenone

GetUsageResponseContent

{
  "properties": {
    "bytes_ingested": {
      "type": "number"
    },
    "bytes_ingested_limit": {
      "type": "number"
    },
    "rag_queries": {
      "type": "number"
    },
    "rag_queries_limit": {
      "type": "number"
    },
    "runtime_seconds": {
      "type": "number"
    },
    "runtime_seconds_limit": {
      "type": "number"
    },
    "usage_period_end": {
      "format": "date-time",
      "type": "string"
    },
    "usage_period_start": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "bytes_ingested",
    "bytes_ingested_limit",
    "rag_queries",
    "rag_queries_limit",
    "runtime_seconds",
    "runtime_seconds_limit",
    "usage_period_end",
    "usage_period_start"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bytes_ingestednumbertruenonenone
bytes_ingested_limitnumbertruenonenone
rag_queriesnumbertruenonenone
rag_queries_limitnumbertruenonenone
runtime_secondsnumbertruenonenone
runtime_seconds_limitnumbertruenonenone
usage_period_endstring(date-time)truenonenone
usage_period_startstring(date-time)truenonenone

GetUserResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
emailstringtruenonenone
namestringfalsenonenone
organizations[string]truenonenone
updated_atstring(date-time)truenonenone
user_idstringtruenonenone

GitHubAppDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
app_idstringtruenonenone
integration_endpointstringtruenonenone
private_key_secret_refstringtruenonenone
webhook_secret_refstringtruenonenone

GitHubAppInput

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
app_idstringfalsenonenone
private_key_secret_refstringfalsenonenone
webhook_secret_refstringfalsenonenone

GitHubCredentialsInput

{
  "properties": {
    "auth_code": {
      "type": "string"
    }
  },
  "required": [
    "auth_code"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
auth_codestringtruenonenone

GithubCodeSource

{
  "properties": {
    "commit_sha": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
commit_shastringfalsenonenone

GithubCodeSourceInput

{
  "properties": {
    "access_token": {
      "maxLength": 1000,
      "minLength": 1,
      "type": "string"
    },
    "commit_sha": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
access_tokenstringfalsenonenone
commit_shastringfalsenonenone

GithubFunctionCode

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringtruenonenone
ownerstringtruenonenone
pushGithubFunctionCodePushConfigtruenonenone

GithubFunctionCodePushConfig

{
  "properties": {
    "branch": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "tag": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "branch"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
branchstringtruenonenone
tagstringfalsenonenone

GithubStructureCode

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringtruenonenone
ownerstringtruenonenone
pushGithubStructureCodePushConfigtruenonenone

GithubStructureCodePushConfig

{
  "properties": {
    "branch": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "tag": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "branch"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
branchstringtruenonenone
tagstringfalsenonenone

GithubToolCode

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringtruenonenone
ownerstringtruenonenone
pushGithubToolCodePushConfigtruenonenone

GithubToolCodePushConfig

{
  "properties": {
    "branch": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "tag": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "branch"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
branchstringtruenonenone
tagstringfalsenonenone

GoogleDriveDetail

{
  "properties": {
    "access_token": {
      "type": "string"
    },
    "file_ids": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "access_token",
    "file_ids"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
access_tokenstringtruenonenone
file_ids[string]truenonenone

GoogleDriveInput

{
  "properties": {
    "auth_code": {
      "type": "string"
    },
    "file_ids": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "auth_code",
    "file_ids"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
auth_codestringtruenonenone
file_ids[string]truenonenone

IntegrationConfigInputUnion

{
  "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"
    }
  ]
}

Properties

oneOf

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» slackSlackInputtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» github_appGitHubAppInputtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» webhookWebhookInputtruenonenone

IntegrationConfigUnion

{
  "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"
    }
  ]
}

Properties

oneOf

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» slackSlackDetailtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» github_appGitHubAppDetailtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» webhookWebhookDetailtruenonenone

IntegrationDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_ids[string]truenonenone
configIntegrationConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
integration_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
structure_ids[string]truenonenone
typeIntegrationTypetruenonenone
updated_atstring(date-time)truenonenone

IntegrationType

{
  "enum": [
    "slack",
    "github_app",
    "webhook"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousslack
anonymousgithub_app
anonymouswebhook

InviteDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
emailstringtruenonenone
expires_atstring(date-time)truenonenone
invite_idstringtruenonenone
organization_idstringtruenonenone
responded_atstring(date-time)falsenonenone
statusInviteStatustruenonenone

InviteResponseStatus

{
  "enum": [
    "ACCEPTED",
    "REJECTED"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousACCEPTED
anonymousREJECTED

InviteStatus

{
  "enum": [
    "ACCEPTED",
    "EXPIRED",
    "PENDING",
    "REJECTED"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousACCEPTED
anonymousEXPIRED
anonymousPENDING
anonymousREJECTED

InvokeStructureWebhookGetResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeStructureCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
structure_config_filestringfalsenonenone
structure_idstringtruenonenone
updated_atstring(date-time)truenonenone
webhook_enabledbooleantruenonenone

InvokeStructureWebhookPostResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeStructureCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
structure_config_filestringfalsenonenone
structure_idstringtruenonenone
updated_atstring(date-time)truenonenone
webhook_enabledbooleantruenonenone

JsonSchema

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
additionalPropertiesbooleantruenonenone
descriptionstringtruenonenone
idstringtruenonenone
propertiesJsonSchemaPropertiestruenonenone
required[string]truenonenone
schemastringtruenonenone
titlestringtruenonenone
typestringtruenonenone

JsonSchemaProperties

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
memberJsonSchemaPropertyfalsenonenone

JsonSchemaProperty

{
  "properties": {
    "additionalProperties": {
      "type": "boolean"
    },
    "description": {
      "type": "string"
    },
    "properties": {
      "properties": {
        "member": "[Circular]"
      },
      "type": "object"
    },
    "required": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "additionalProperties",
    "description",
    "properties",
    "required",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
additionalPropertiesbooleantruenonenone
descriptionstringtruenonenone
propertiesJsonSchemaPropertiestruenonenone
required[string]truenonenone
typestringtruenonenone

KnowledgeBaseConfigInputUnion

{
  "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"
    }
  ]
}

Properties

oneOf

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» pg_vectorPGVectorKnowledgeBaseInputtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» gtc_pg_vectorGTCPGVectorKnowledgeBaseInputtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» gtc_hybrid_sql_pg_vectorGTCHybidSQLPGVectorKnowledgeBaseInputtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» pgai_knowledge_basePGAIKnowledgeBaseKnowledgeBaseInputtruenonenone

KnowledgeBaseConfigUnion

{
  "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"
    }
  ]
}

Properties

oneOf

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» pg_vectorPGVectorKnowledgeBaseDetailtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» gtc_pg_vectorGTCPGVectorKnowledgeBaseDetailtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» gtc_hybrid_sql_pg_vectorGTCHybidSQLPGVectorKnowledgeBaseDetailtruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» pgai_knowledge_basePGAIKnowledgeBaseKnowledgeBaseDetailtruenonenone

KnowledgeBaseDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_paths[string]truenonenone
configKnowledgeBaseConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
embedding_modelEmbeddingModelfalsenonenone
knowledge_base_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
schedule_expressionstringfalsenonenone
transforms[TransformDetail]falsenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone
use_default_embedding_modelbooleanfalsenonenone

KnowledgeBaseJobDetail

{
  "properties": {
    "bytes_ingested": {
      "type": "number"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "errors": {
      "items": {
        "properties": {
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "message",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "knowledge_base_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "knowledge_base_job_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "status": {
      "enum": [
        "QUEUED",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {}
  },
  "required": [
    "created_at",
    "created_by",
    "knowledge_base_id",
    "knowledge_base_job_id",
    "status"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bytes_ingestednumberfalsenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
errors[Error]falsenonenone
knowledge_base_idstringtruenonenone
knowledge_base_job_idstringtruenonenone
statusKnowledgeBaseJobStatustruenonenone
status_detailanyfalsenonenone

KnowledgeBaseJobStatus

{
  "enum": [
    "QUEUED",
    "RUNNING",
    "SUCCEEDED",
    "FAILED",
    "CANCELLED"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousQUEUED
anonymousRUNNING
anonymousSUCCEEDED
anonymousFAILED
anonymousCANCELLED

KnowledgeBaseQueryDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
entries[Entry]truenonenone
knowledge_base_idstringtruenonenone
knowledge_base_query_idstringtruenonenone
querystringtruenonenone

KnowledgeBaseSearchDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
knowledge_base_idstringtruenonenone
knowledge_base_search_idstringtruenonenone
querystringtruenonenone
resultstringtruenonenone

LibraryDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_ids[string]truenonenone
descriptionstringfalsenonenone
knowledge_base_ids[string]truenonenone
library_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_idstringtruenonenone
updated_atstring(date-time)truenonenone

ListApiKeysResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
api_keys[ApiKeyDetail]truenonenone
paginationPaginationtruenonenone

ListAssetsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assets[AssetDetail]truenonenone
paginationPaginationtruenonenone
postfixstringfalsenonenone
prefixstringfalsenonenone

ListAssistantEventsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
countnumbertruenonenone
events[AssistantEventDetail]truenonenone
limitnumbertruenonenone
next_offsetnumbertruenonenone
offsetnumbertruenonenone
total_countnumbertruenonenone

ListAssistantRunsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_runs[AssistantRunDetail]truenonenone
paginationPaginationtruenonenone

ListAssistantsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistants[AssistantDetail]truenonenone
paginationPaginationtruenonenone

ListBucketsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
buckets[BucketDetail]truenonenone
paginationPaginationtruenonenone

ListConnectionsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
connections[ConnectionDetail]falsenonenone

ListDataConnectorsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
data_connectors[DataConnectorDetail]truenonenone
paginationPaginationtruenonenone

ListDataJobsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
data_jobs[DataJobDetail]truenonenone
paginationPaginationtruenonenone

ListEventsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
countnumbertruenonenone
events[EventDetail]truenonenone
limitnumbertruenonenone
next_offsetnumbertruenonenone
offsetnumbertruenonenone
total_countnumbertruenonenone

ListFunctionDeploymentsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
deployments[FunctionDeploymentDetail]truenonenone
paginationPaginationtruenonenone

ListFunctionRunLogsResponseContent

{
  "properties": {
    "logs": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "logs"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
logs[string]truenonenone

ListFunctionRunsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
function_runs[FunctionRunDetail]truenonenone
paginationPaginationtruenonenone

ListFunctionsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
functions[FunctionDetail]truenonenone
paginationPaginationtruenonenone

ListIntegrationsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
integrations[IntegrationDetail]truenonenone
paginationPaginationtruenonenone

ListInvitesResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
invites[InviteDetail]truenonenone
paginationPaginationtruenonenone

ListKnowledgeBaseJobsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
knowledge_base_jobs[KnowledgeBaseJobDetail]truenonenone
paginationPaginationtruenonenone

ListKnowledgeBaseQueriesResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
knowledge_base_queries[KnowledgeBaseQueryDetail]falsenonenone

ListKnowledgeBaseSearchesResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
knowledge_base_searches[KnowledgeBaseSearchDetail]falsenonenone

ListKnowledgeBasesResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
knowledge_bases[KnowledgeBaseDetail]truenonenone
paginationPaginationtruenonenone

ListLibrariesResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
libraries[LibraryDetail]truenonenone
paginationPaginationtruenonenone

ListMessagesResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
messages[MessageDetail]truenonenone
paginationPaginationtruenonenone

ListModelsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
models[ModelDetail]truenonenone
paginationPaginationtruenonenone

ListOrganizationApiKeysResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
api_keys[ApiKeyDetail]truenonenone
paginationPaginationtruenonenone

ListOrganizationUsersResponseContent

{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "users": {
      "items": {
        "properties": {
          "email": {
            "type": "string"
          },
          "user_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          }
        },
        "required": [
          "email",
          "user_id"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "users"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
users[OrganizationUserDetail]truenonenone

ListOrganizationsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
organizations[OrganizationDetail]falsenonenone

ListRetrieverComponentsResponseContent

{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_component_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "config",
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_component_id",
          "type",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "retriever_components"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
retriever_components[RetrieverComponentDetail]truenonenone

ListRetrieversResponseContent

{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "retrievers": {
      "items": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_components": {
            "items": {
              "properties": {
                "config": {},
                "created_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "created_by": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "organization_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                },
                "retriever_component_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                },
                "type": {
                  "type": "string"
                },
                "updated_at": {
                  "format": "date-time",
                  "type": "string"
                }
              },
              "required": [
                "config",
                "created_at",
                "created_by",
                "name",
                "organization_id",
                "retriever_component_id",
                "type",
                "updated_at"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "retriever_components_schema": {},
          "retriever_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_components",
          "retriever_components_schema",
          "retriever_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "retrievers"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
retrievers[RetrieverDetail]truenonenone

ListRulesResponseContent

{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "rules": {
      "items": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "rule": {
            "type": "string"
          },
          "rule_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "created_at",
          "created_by",
          "metadata",
          "name",
          "organization_id",
          "rule",
          "rule_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "rules"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
rules[RuleDetail]truenonenone

ListRulesetsResponseContent

{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "rulesets": {
      "items": {
        "properties": {
          "alias": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "rule_ids": {
            "items": {
              "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
              "type": "string"
            },
            "type": "array"
          },
          "ruleset_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "alias",
          "created_at",
          "created_by",
          "description",
          "metadata",
          "name",
          "organization_id",
          "rule_ids",
          "ruleset_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "rulesets"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
rulesets[RulesetDetail]truenonenone

ListSecretsResponseContent

{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "secrets": {
      "items": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "last_used": {
            "format": "date-time",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "secret_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "created_at",
          "last_used",
          "name",
          "organization_id",
          "secret_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "secrets"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
secrets[SecretDetail]truenonenone

ListSpansResponseContent

{
  "properties": {
    "page": {
      "type": "number"
    },
    "spans": {
      "items": {
        "properties": {
          "attributes": {},
          "end_time": {
            "format": "date-time",
            "type": "string"
          },
          "events": {
            "properties": {
              "attributes": {},
              "name": {
                "type": "string"
              },
              "timestamp": {
                "format": "date-time",
                "type": "string"
              }
            },
            "required": [
              "attributes",
              "name",
              "timestamp"
            ],
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "parent_id": {
            "type": "string"
          },
          "span_id": {
            "type": "string"
          },
          "start_time": {
            "format": "date-time",
            "type": "string"
          },
          "status": {
            "enum": [
              "UNSET",
              "OK",
              "ERROR"
            ],
            "type": "string"
          },
          "trace_id": {
            "type": "string"
          }
        },
        "required": [
          "attributes",
          "end_time",
          "events",
          "name",
          "span_id",
          "start_time",
          "status",
          "trace_id"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "spans"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
pagenumberfalsenonenone
spans[SpanDetail]truenonenone

ListStructureDeploymentsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
deployments[StructureDeploymentDetail]truenonenone
paginationPaginationtruenonenone

ListStructureRunLogsResponseContent

{
  "properties": {
    "logs": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "logs"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
logs[string]truenonenone

ListStructureRunsResponseContent

{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "structure_runs": {
      "items": {
        "properties": {
          "args": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "completed_at": {
            "default": null,
            "format": "date-time",
            "type": "string",
            "nullable": true
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "deployment_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "env_vars": {
            "items": {
              "properties": {
                "name": {
                  "type": "string"
                },
                "source": {
                  "enum": [
                    "secret_ref",
                    "manual"
                  ],
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "value"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "output": {},
          "output_timestamp": {
            "format": "double",
            "type": "number"
          },
          "started_at": {
            "default": null,
            "format": "date-time",
            "type": "string",
            "nullable": true
          },
          "status": {
            "enum": [
              "QUEUED",
              "STARTING",
              "RUNNING",
              "SUCCEEDED",
              "FAILED",
              "ERROR",
              "CANCELLED"
            ],
            "type": "string"
          },
          "status_detail": {},
          "structure_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "structure_run_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "args",
          "completed_at",
          "created_at",
          "created_by",
          "started_at",
          "status",
          "structure_id",
          "structure_run_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "structure_runs"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
structure_runs[StructureRunDetail]truenonenone

ListStructuresResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
structures[StructureDetail]truenonenone

ListThreadsResponseContent

{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "threads": {
      "items": {
        "properties": {
          "alias": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "thread_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "alias",
          "created_at",
          "created_by",
          "metadata",
          "name",
          "organization_id",
          "thread_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "threads"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
threads[ThreadDetail]truenonenone

ListToolDeploymentsResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
deployments[ToolDeploymentDetail]truenonenone
paginationPaginationtruenonenone

ListToolRunLogsResponseContent

{
  "properties": {
    "logs": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "logs"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
logs[string]truenonenone

ListToolRunsResponseContent

{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "tool_runs": {
      "items": {
        "properties": {
          "completed_at": {
            "default": null,
            "format": "date-time",
            "type": "string",
            "nullable": true
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "deployment_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "env_vars": {
            "items": {
              "properties": {
                "name": {
                  "type": "string"
                },
                "source": {
                  "enum": [
                    "secret_ref",
                    "manual"
                  ],
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "value"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "input": {},
          "output": {},
          "output_timestamp": {
            "format": "double",
            "type": "number"
          },
          "runtime_path": {
            "type": "string"
          },
          "started_at": {
            "default": null,
            "format": "date-time",
            "type": "string",
            "nullable": true
          },
          "status": {
            "enum": [
              "QUEUED",
              "STARTING",
              "RUNNING",
              "SUCCEEDED",
              "FAILED",
              "ERROR",
              "CANCELLED"
            ],
            "type": "string"
          },
          "status_detail": {},
          "tool_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "tool_run_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "completed_at",
          "created_at",
          "created_by",
          "input",
          "runtime_path",
          "started_at",
          "status",
          "tool_id",
          "tool_run_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "tool_runs"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
tool_runs[ToolRunDetail]truenonenone

ListToolsResponseContent

{
  "properties": {
    "pagination": {
      "properties": {
        "next_page": {
          "type": "number"
        },
        "page_number": {
          "type": "number"
        },
        "page_size": {
          "type": "number"
        },
        "previous_page": {
          "type": "number"
        },
        "total_count": {
          "type": "number"
        },
        "total_pages": {
          "type": "number"
        }
      },
      "required": [
        "page_number",
        "page_size",
        "total_count",
        "total_pages"
      ],
      "type": "object"
    },
    "tools": {
      "items": {
        "properties": {
          "code": {
            "oneOf": [
              {
                "properties": {
                  "github": {
                    "properties": {
                      "name": {
                        "maxLength": 200,
                        "minLength": 1,
                        "type": "string"
                      },
                      "owner": {
                        "maxLength": 200,
                        "minLength": 1,
                        "type": "string"
                      },
                      "push": {
                        "properties": {
                          "branch": {
                            "maxLength": 200,
                            "minLength": 1,
                            "type": "string"
                          },
                          "tag": {
                            "maxLength": 200,
                            "minLength": 1,
                            "type": "string"
                          }
                        },
                        "required": [
                          "branch"
                        ],
                        "type": "object"
                      }
                    },
                    "required": [
                      "name",
                      "owner",
                      "push"
                    ],
                    "type": "object"
                  }
                },
                "required": [
                  "github"
                ],
                "title": "github",
                "type": "object"
              },
              {
                "properties": {
                  "data_lake": {
                    "properties": {
                      "asset_path": {
                        "type": "string"
                      },
                      "bucket_id": {
                        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                        "type": "string"
                      }
                    },
                    "required": [
                      "asset_path",
                      "bucket_id"
                    ],
                    "type": "object"
                  }
                },
                "required": [
                  "data_lake"
                ],
                "title": "data_lake",
                "type": "object"
              },
              {
                "properties": {
                  "default": {
                    "type": "object"
                  }
                },
                "required": [
                  "default"
                ],
                "title": "default",
                "type": "object"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "env_vars": {
            "items": {
              "properties": {
                "name": {
                  "type": "string"
                },
                "source": {
                  "enum": [
                    "secret_ref",
                    "manual"
                  ],
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "value"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "latest_deployment_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "tool_config_file": {
            "type": "string"
          },
          "tool_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "code",
          "created_at",
          "created_by",
          "description",
          "env_vars",
          "latest_deployment_id",
          "name",
          "organization_id",
          "tool_id",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "pagination",
    "tools"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
paginationPaginationtruenonenone
tools[ToolDetail]truenonenone

ListUserInvitesResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
invites[InviteDetail]truenonenone
paginationPaginationtruenonenone

ListUsersResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
users[UserDetail]falsenonenone

MessageContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
artifactArtifacttruenonenone
typestringtruenonenone

MessageDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
indexnumbertruenonenone
inputstringtruenonenone
message_idstringtruenonenone
metadataMetadatatruenonenone
outputstringtruenonenone
thread_idstringtruenonenone
updated_atstring(date-time)truenonenone

MessageInput

{
  "properties": {
    "input": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "output": {
      "type": "string"
    }
  },
  "required": [
    "input",
    "output"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
inputstringtruenonenone
metadataMetadatafalsenonenone
outputstringtruenonenone

Meta

{
  "additionalProperties": {
    "type": "string"
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
additionalPropertiesstringfalsenonenone

Metadata

{
  "additionalProperties": {},
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
additionalPropertiesanyfalsenonenone

ModelDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
defaultbooleantruenonenone
descriptionstringfalsenonenone
model_namestringtruenonenone
model_typeModelTypetruenonenone

ModelTokenCounts

{
  "properties": {
    "input": {
      "format": "float",
      "type": "number"
    },
    "output": {
      "format": "float",
      "type": "number"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
inputnumber(float)falsenonenone
outputnumber(float)falsenonenone

ModelTokenCountsMap

{
  "additionalProperties": {
    "properties": {
      "input": {
        "format": "float",
        "type": "number"
      },
      "output": {
        "format": "float",
        "type": "number"
      }
    },
    "type": "object"
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
additionalPropertiesModelTokenCountsfalsenonenone

ModelType

{
  "enum": [
    "chat",
    "embedding",
    "rerank",
    "image_generation",
    "unknown"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymouschat
anonymousembedding
anonymousrerank
anonymousimage_generation
anonymousunknown

ObservabilityEvent

{
  "properties": {
    "attributes": {},
    "name": {
      "type": "string"
    },
    "timestamp": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "attributes",
    "name",
    "timestamp"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
attributesanytruenonenone
namestringtruenonenone
timestampstring(date-time)truenonenone

OrganizationDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
default_bucket_idstringtruenonenone
descriptionstringtruenonenone
entitlementanytruenonenone

allOf

NameTypeRequiredRestrictionsDescription
» anonymousEntitlementfalsenonenone

and

NameTypeRequiredRestrictionsDescription
» anonymousanyfalsenonenone

continued

NameTypeRequiredRestrictionsDescription
model_configOrganizationModelConfigfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

OrganizationModelConfig

{
  "properties": {
    "default_chat_model": {
      "type": "string"
    },
    "default_embedding_model": {
      "type": "string"
    },
    "default_image_generation_model": {
      "type": "string"
    },
    "default_rerank_model": {
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
default_chat_modelstringfalsenonenone
default_embedding_modelstringfalsenonenone
default_image_generation_modelstringfalsenonenone
default_rerank_modelstringfalsenonenone

OrganizationUserDetail

{
  "properties": {
    "email": {
      "type": "string"
    },
    "user_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    }
  },
  "required": [
    "email",
    "user_id"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
emailstringtruenonenone
user_idstringtruenonenone

PGAIKnowledgeBaseKnowledgeBaseDetail

{
  "properties": {
    "knowledge_base_name": {
      "type": "string"
    },
    "query_schema": {}
  },
  "required": [
    "knowledge_base_name",
    "query_schema"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
knowledge_base_namestringtruenonenone
query_schemaanytruenonenone

PGAIKnowledgeBaseKnowledgeBaseInput

{
  "type": "object"
}

Properties

None

PGVectorKnowledgeBaseDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
connection_stringstringtruenonenone
embedding_modelstringtruenonenone
query_schemaanytruenonenone
use_default_embedding_modelbooleantruenonenone

PGVectorKnowledgeBaseInput

{
  "properties": {
    "connection_string": {
      "type": "string"
    },
    "embedding_model": {
      "type": "string"
    },
    "password": {
      "type": "string"
    },
    "use_default_embedding_model": {
      "type": "boolean"
    }
  },
  "required": [
    "connection_string",
    "password"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
connection_stringstringtruenonenone
embedding_modelstringfalsenonenone
passwordstringtruenonenone
use_default_embedding_modelbooleanfalsenonenone

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"
}

Properties

NameTypeRequiredRestrictionsDescription
next_pagenumberfalsenonenone
page_numbernumbertruenonenone
page_sizenumbertruenonenone
previous_pagenumberfalsenonenone
total_countnumbertruenonenone
total_pagesnumbertruenonenone

Period

{
  "enum": [
    "1m",
    "1h",
    "1d",
    "1w"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymous1m
anonymous1h
anonymous1d
anonymous1w

QueryKnowledgeBaseRequestContent

{
  "properties": {
    "query": {
      "type": "string"
    },
    "query_args": {}
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
querystringfalsenonenone
query_argsanyfalsenonenone

QueryKnowledgeBaseResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
entries[Entry]truenonenone
knowledge_base_idstringtruenonenone
knowledge_base_query_idstringtruenonenone
querystringtruenonenone

QueryRetrieverRequestContent

{
  "properties": {
    "query": {
      "type": "string"
    },
    "retriever_components_query_args": {}
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
querystringtruenonenone
retriever_components_query_argsanyfalsenonenone

QueryRetrieverResponseContent

{
  "properties": {
    "outputs": {
      "items": {},
      "type": "array"
    }
  },
  "required": [
    "outputs"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
outputs[any]truenonenone

RespondToInviteRequestContent

{
  "properties": {
    "response": {
      "enum": [
        "ACCEPTED",
        "REJECTED"
      ],
      "type": "string"
    }
  },
  "required": [
    "response"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
responseInviteResponseStatustruenonenone

RetrieverComponentDetail

{
  "properties": {
    "config": {},
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_component_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "config",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_component_id",
    "type",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
configanytruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_component_idstringtruenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone

RetrieverComponentInput

{
  "properties": {
    "config": {},
    "description": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "name",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
configanyfalsenonenone
descriptionstringfalsenonenone
namestringtruenonenone
typestringtruenonenone

RetrieverDetail

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_component_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "config",
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_component_id",
          "type",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "retriever_components_schema": {},
    "retriever_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_components",
    "retriever_components_schema",
    "retriever_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_components[RetrieverComponentDetail]truenonenone
retriever_components_schemaanytruenonenone
retriever_idstringtruenonenone
updated_atstring(date-time)truenonenone

RuleDetail

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule": {
      "type": "string"
    },
    "rule_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "rule",
    "rule_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
rulestringtruenonenone
rule_idstringtruenonenone
updated_atstring(date-time)truenonenone

RulesetDetail

{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "description",
    "metadata",
    "name",
    "organization_id",
    "rule_ids",
    "ruleset_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
rule_ids[string]truenonenone
ruleset_idstringtruenonenone
updated_atstring(date-time)truenonenone

RunCountGauge

{
  "properties": {
    "active_count": {
      "type": "number"
    },
    "total_count": {
      "type": "number"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
active_countnumberfalsenonenone
total_countnumberfalsenonenone

RunDurationGauge

{
  "properties": {
    "activity_durations": {
      "items": {
        "properties": {
          "activity_type": {
            "type": "string"
          },
          "seconds": {
            "type": "number"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "total_seconds": {
      "type": "number"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
activity_durations[ActivityDuration]falsenonenone
total_secondsnumberfalsenonenone

S3ConnectorDetail

{
  "properties": {
    "aws_access_key_id": {
      "type": "string"
    },
    "uris": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "aws_access_key_id",
    "uris"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aws_access_key_idstringtruenonenone
uris[string]truenonenone

S3ConnectorInput

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
aws_access_key_idstringtruenonenone
aws_secret_access_keystringtruenonenone
uris[string]truenonenone

SearchKnowledgeBaseRequestContent

{
  "properties": {
    "query": {
      "type": "string"
    },
    "query_args": {}
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
querystringtruenonenone
query_argsanyfalsenonenone

SearchKnowledgeBaseResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
knowledge_base_idstringtruenonenone
knowledge_base_search_idstringtruenonenone
querystringtruenonenone
resultstringtruenonenone

SecretDetail

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "secret_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "last_used",
    "name",
    "organization_id",
    "secret_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
last_usedstring(date-time)truenonenone
namestringtruenonenone
organization_idstringtruenonenone
secret_idstringtruenonenone
updated_atstring(date-time)truenonenone

ServiceErrorResponseContent

{
  "properties": {
    "errors": {
      "items": {},
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
errors[any]falsenonenone
typestringtruenonenone

SlackDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
app_descriptionstringtruenonenone
app_display_namestringtruenonenone
app_manifestanytruenonenone
app_namestringtruenonenone
bot_token_secret_refstringtruenonenone
signing_secret_secret_refstringtruenonenone

SlackInput

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
app_descriptionstringtruenonenone
app_display_namestringtruenonenone
app_namestringtruenonenone
bot_token_secret_refstringfalsenonenone
signing_secret_secret_refstringfalsenonenone

SpanDetail

{
  "properties": {
    "attributes": {},
    "end_time": {
      "format": "date-time",
      "type": "string"
    },
    "events": {
      "properties": {
        "attributes": {},
        "name": {
          "type": "string"
        },
        "timestamp": {
          "format": "date-time",
          "type": "string"
        }
      },
      "required": [
        "attributes",
        "name",
        "timestamp"
      ],
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "parent_id": {
      "type": "string"
    },
    "span_id": {
      "type": "string"
    },
    "start_time": {
      "format": "date-time",
      "type": "string"
    },
    "status": {
      "enum": [
        "UNSET",
        "OK",
        "ERROR"
      ],
      "type": "string"
    },
    "trace_id": {
      "type": "string"
    }
  },
  "required": [
    "attributes",
    "end_time",
    "events",
    "name",
    "span_id",
    "start_time",
    "status",
    "trace_id"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
attributesanytruenonenone
end_timestring(date-time)truenonenone
eventsObservabilityEventtruenonenone
namestringtruenonenone
parent_idstringfalsenonenone
span_idstringtruenonenone
start_timestring(date-time)truenonenone
statusSpanStatustruenonenone
trace_idstringtruenonenone

SpanStatus

{
  "enum": [
    "UNSET",
    "OK",
    "ERROR"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousUNSET
anonymousOK
anonymousERROR

StreamMessageContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
artifactArtifacttruenonenone
typestringtruenonenone

StructureCode

{
  "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"
    }
  ]
}

Properties

oneOf

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» githubGithubStructureCodetruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» data_lakeDataLakeStructureCodetruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» defaultDefaultStructureCodetruenonenone

StructureConnectorDetail

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "structure_id": {
      "type": "string"
    }
  },
  "required": [
    "structure_id"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]falsenonenone
structure_idstringtruenonenone

StructureConnectorInput

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "structure_id": {
      "type": "string"
    }
  },
  "required": [
    "structure_id"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]falsenonenone
structure_idstringtruenonenone

StructureDeploymentDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
code_sourceCodeSourcetruenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringtruenonenone
statusDeploymentStatustruenonenone
status_detailanyfalsenonenone
structure_idstringtruenonenone

StructureDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeStructureCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
structure_config_filestringfalsenonenone
structure_idstringtruenonenone
updated_atstring(date-time)truenonenone
webhook_enabledbooleantruenonenone

StructureRunDetail

{
  "properties": {
    "args": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "output": {},
    "output_timestamp": {
      "format": "double",
      "type": "number"
    },
    "started_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "structure_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "structure_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "args",
    "completed_at",
    "created_at",
    "created_by",
    "started_at",
    "status",
    "structure_id",
    "structure_run_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
args[string]truenonenone
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringfalsenonenone
env_vars[EnvVar]falsenonenone
outputanyfalsenonenone
output_timestampnumber(double)falsenonenone
started_atstring(date-time)¦nulltruenonenone
statusStructureRunStatustruenonenone
status_detailanyfalsenonenone
structure_idstringtruenonenone
structure_run_idstringtruenonenone
updated_atstring(date-time)truenonenone

StructureRunStatus

{
  "enum": [
    "QUEUED",
    "STARTING",
    "RUNNING",
    "SUCCEEDED",
    "FAILED",
    "ERROR",
    "CANCELLED"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousQUEUED
anonymousSTARTING
anonymousRUNNING
anonymousSUCCEEDED
anonymousFAILED
anonymousERROR
anonymousCANCELLED

StructuredColumnDetail

{
  "properties": {
    "column_name": {
      "type": "string"
    },
    "sql_type": {
      "type": "string"
    }
  },
  "required": [
    "column_name",
    "sql_type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
column_namestringtruenonenone
sql_typestringtruenonenone

StructuredColumnInput

{
  "properties": {
    "column_name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "sql_type": {
      "type": "string"
    }
  },
  "required": [
    "column_name",
    "description",
    "sql_type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
column_namestringtruenonenone
descriptionstringtruenonenone
sql_typestringtruenonenone

ThreadDetail

{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "thread_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
thread_idstringtruenonenone
updated_atstring(date-time)truenonenone

TokenCountGauge

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
by_modelModelTokenCountsMapfalsenonenone
inputnumber(float)falsenonenone
outputnumber(float)falsenonenone

ToolCode

{
  "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"
    }
  ]
}

Properties

oneOf

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» githubGithubToolCodetruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» data_lakeDataLakeToolCodetruenonenone

xor

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» defaultDefaultToolCodetruenonenone

ToolDeploymentDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
code_sourceCodeSourcetruenonenone
completed_atstring(date-time)¦nullfalsenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringtruenonenone
statusDeploymentStatustruenonenone
status_detailanyfalsenonenone
tool_idstringtruenonenone

ToolDetail

{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "latest_deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_config_file": {
      "type": "string"
    },
    "tool_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "code",
    "created_at",
    "created_by",
    "description",
    "env_vars",
    "latest_deployment_id",
    "name",
    "organization_id",
    "tool_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
codeToolCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
tool_config_filestringfalsenonenone
tool_idstringtruenonenone
updated_atstring(date-time)truenonenone

ToolRunDetail

{
  "properties": {
    "completed_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "input": {},
    "output": {},
    "output_timestamp": {
      "format": "double",
      "type": "number"
    },
    "runtime_path": {
      "type": "string"
    },
    "started_at": {
      "default": null,
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "status": {
      "enum": [
        "QUEUED",
        "STARTING",
        "RUNNING",
        "SUCCEEDED",
        "FAILED",
        "ERROR",
        "CANCELLED"
      ],
      "type": "string"
    },
    "status_detail": {},
    "tool_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_run_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "completed_at",
    "created_at",
    "created_by",
    "input",
    "runtime_path",
    "started_at",
    "status",
    "tool_id",
    "tool_run_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
completed_atstring(date-time)¦nulltruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
deployment_idstringfalsenonenone
env_vars[EnvVar]falsenonenone
inputanytruenonenone
outputanyfalsenonenone
output_timestampnumber(double)falsenonenone
runtime_pathstringtruenonenone
started_atstring(date-time)¦nulltruenonenone
statusToolRunStatustruenonenone
status_detailanyfalsenonenone
tool_idstringtruenonenone
tool_run_idstringtruenonenone
updated_atstring(date-time)truenonenone

ToolRunStatus

{
  "enum": [
    "QUEUED",
    "STARTING",
    "RUNNING",
    "SUCCEEDED",
    "FAILED",
    "ERROR",
    "CANCELLED"
  ],
  "type": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone
Enumerated Values
PropertyValue
anonymousQUEUED
anonymousSTARTING
anonymousRUNNING
anonymousSUCCEEDED
anonymousFAILED
anonymousERROR
anonymousCANCELLED

TransformDetail

{
  "properties": {
    "structure": {
      "properties": {
        "args": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "structure_id": {
          "type": "string"
        }
      },
      "required": [
        "structure_id"
      ],
      "type": "object"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
structureStructureConnectorDetailfalsenonenone

TransformInput

{
  "properties": {
    "structure": {
      "properties": {
        "args": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "structure_id": {
          "type": "string"
        }
      },
      "required": [
        "structure_id"
      ],
      "type": "object"
    }
  },
  "required": [
    "structure"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
structureStructureConnectorInputtruenonenone

UnstructuredColumnDetail

{
  "properties": {
    "column_name": {
      "type": "string"
    }
  },
  "required": [
    "column_name"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
column_namestringtruenonenone

UnstructuredColumnInput

{
  "properties": {
    "column_name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  },
  "required": [
    "column_name",
    "description"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
column_namestringtruenonenone
descriptionstringtruenonenone

UpdateApiKeyRequestContent

{
  "properties": {
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringfalsenonenone

UpdateApiKeyResponseContent

{
  "properties": {
    "active": {
      "type": "boolean"
    },
    "api_key_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "active",
    "api_key_id",
    "created_at",
    "created_by",
    "last_used",
    "name",
    "organization_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
activebooleantruenonenone
api_key_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
last_usedstring(date-time)truenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateAssistantRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
descriptionstringfalsenonenone
inputstringfalsenonenone
knowledge_base_ids[string]falsenonenone
namestringfalsenonenone
ruleset_ids[string]falsenonenone
structure_ids[string]falsenonenone
tool_ids[string]falsenonenone

UpdateAssistantResponseContent

{
  "properties": {
    "assistant_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "knowledge_base_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "structure_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "tool_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "assistant_id",
    "created_at",
    "created_by",
    "description",
    "knowledge_base_ids",
    "name",
    "organization_id",
    "retriever_ids",
    "ruleset_ids",
    "structure_ids",
    "tool_ids",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
inputstringfalsenonenone
knowledge_base_ids[string]truenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_ids[string]truenonenone
ruleset_ids[string]truenonenone
structure_ids[string]truenonenone
tool_ids[string]truenonenone
updated_atstring(date-time)truenonenone

UpdateBucketRequestContent

{
  "properties": {
    "name": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringfalsenonenone

UpdateBucketResponseContent

{
  "properties": {
    "bucket_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "bucket_id",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
bucket_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateDataConnectorRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
configDataConnectorConfigInputUnionfalsenonenone
descriptionstringfalsenonenone
namestringfalsenonenone
schedule_expressionstringfalsenonenone

UpdateDataConnectorResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
configDataConnectorConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_idstringtruenonenone
data_job_idstringfalsenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
schedule_expressionstringfalsenonenone
transforms[TransformDetail]falsenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone

UpdateFunctionRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeFunctionCodefalsenonenone
descriptionstringfalsenonenone
env_vars[EnvVar]falsenonenone
function_config_filestringfalsenonenone
namestringfalsenonenone

UpdateFunctionResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeFunctionCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
function_config_filestringfalsenonenone
function_idstringtruenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateIntegrationRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_ids[string]falsenonenone
configIntegrationConfigInputUnionfalsenonenone
descriptionstringfalsenonenone
namestringfalsenonenone
structure_ids[string]falsenonenone
typeIntegrationTypefalsenonenone

UpdateIntegrationResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_ids[string]truenonenone
configIntegrationConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
integration_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
structure_ids[string]truenonenone
typeIntegrationTypetruenonenone
updated_atstring(date-time)truenonenone

UpdateKnowledgeBaseRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_paths[string]falsenonenone
configKnowledgeBaseConfigInputUniontruenonenone
descriptionstringfalsenonenone
embedding_modelEmbeddingModelfalsenonenone
namestringfalsenonenone
schedule_expressionstringfalsenonenone
transforms[TransformDetail]falsenonenone
typestringtruenonenone
use_default_embedding_modelbooleanfalsenonenone

UpdateKnowledgeBaseResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
asset_paths[string]truenonenone
configKnowledgeBaseConfigUniontruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
embedding_modelEmbeddingModelfalsenonenone
knowledge_base_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
schedule_expressionstringfalsenonenone
transforms[TransformDetail]falsenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone
use_default_embedding_modelbooleanfalsenonenone

UpdateLibraryRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
data_connector_ids[string]truenonenone
descriptionstringfalsenonenone
knowledge_base_configs[KnowledgeBaseConfigInputUnion]truenonenone
namestringtruenonenone

UpdateLibraryResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
assistant_idstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
data_connector_ids[string]truenonenone
descriptionstringfalsenonenone
knowledge_base_ids[string]truenonenone
library_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateMessageRequestContent

{
  "properties": {
    "input": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "output": {
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
inputstringfalsenonenone
metadataMetadatafalsenonenone
outputstringfalsenonenone

UpdateMessageResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
indexnumbertruenonenone
inputstringtruenonenone
message_idstringtruenonenone
metadataMetadatatruenonenone
outputstringtruenonenone
thread_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateOrganizationRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
model_configOrganizationModelConfigfalsenonenone
namestringfalsenonenone

UpdateOrganizationResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
default_bucket_idstringtruenonenone
descriptionstringtruenonenone
entitlementanytruenonenone

allOf

NameTypeRequiredRestrictionsDescription
» anonymousEntitlementfalsenonenone

and

NameTypeRequiredRestrictionsDescription
» anonymousanyfalsenonenone

continued

NameTypeRequiredRestrictionsDescription
model_configOrganizationModelConfigfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateRetrieverComponentRequestContent

{
  "properties": {
    "config": {},
    "description": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "config",
    "type"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
configanytruenonenone
descriptionstringfalsenonenone
namestringfalsenonenone
typestringtruenonenone

UpdateRetrieverComponentResponseContent

{
  "properties": {
    "config": {},
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_component_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "config",
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_component_id",
    "type",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
configanytruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_component_idstringtruenonenone
typestringtruenonenone
updated_atstring(date-time)truenonenone

UpdateRetrieverRequestContent

{
  "properties": {
    "description": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "name": {
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    },
    "retriever_component_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "description": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "name": {
            "maxLength": 64,
            "minLength": 1,
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
descriptionstringfalsenonenone
namestringfalsenonenone
retriever_component_ids[string]falsenonenone
retriever_components[RetrieverComponentInput]falsenonenone

UpdateRetrieverResponseContent

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "retriever_components": {
      "items": {
        "properties": {
          "config": {},
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "retriever_component_id": {
            "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "config",
          "created_at",
          "created_by",
          "name",
          "organization_id",
          "retriever_component_id",
          "type",
          "updated_at"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "retriever_components_schema": {},
    "retriever_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "name",
    "organization_id",
    "retriever_components",
    "retriever_components_schema",
    "retriever_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringfalsenonenone
namestringtruenonenone
organization_idstringtruenonenone
retriever_components[RetrieverComponentDetail]truenonenone
retriever_components_schemaanytruenonenone
retriever_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateRuleRequestContent

{
  "properties": {
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "rule": {
      "maxLength": 2000,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
metadataMetadatafalsenonenone
namestringfalsenonenone
rulestringfalsenonenone

UpdateRuleResponseContent

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule": {
      "type": "string"
    },
    "rule_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "rule",
    "rule_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
created_bystringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
rulestringtruenonenone
rule_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateRulesetRequestContent

{
  "properties": {
    "alias": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "description": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringfalsenonenone
descriptionstringfalsenonenone
metadataMetadatafalsenonenone
namestringfalsenonenone
rule_ids[string]falsenonenone

UpdateRulesetResponseContent

{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "rule_ids": {
      "items": {
        "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
        "type": "string"
      },
      "type": "array"
    },
    "ruleset_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "description",
    "metadata",
    "name",
    "organization_id",
    "rule_ids",
    "ruleset_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
rule_ids[string]truenonenone
ruleset_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateSecretRequestContent

{
  "properties": {
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "value": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
namestringfalsenonenone
valuestringfalsenonenone

UpdateSecretResponseContent

{
  "properties": {
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "last_used": {
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "secret_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "last_used",
    "name",
    "organization_id",
    "secret_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
last_usedstring(date-time)truenonenone
namestringtruenonenone
organization_idstringtruenonenone
secret_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateStructureRequestContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeStructureCodefalsenonenone
descriptionstringfalsenonenone
env_vars[EnvVar]falsenonenone
namestringfalsenonenone
structure_config_filestringfalsenonenone
webhook_enabledbooleanfalsenonenone

UpdateStructureResponseContent

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
codeStructureCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
structure_config_filestringfalsenonenone
structure_idstringtruenonenone
updated_atstring(date-time)truenonenone
webhook_enabledbooleantruenonenone

UpdateThreadRequestContent

{
  "properties": {
    "alias": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "messages": {
      "items": {
        "properties": {
          "input": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": {},
            "type": "object"
          },
          "output": {
            "type": "string"
          }
        },
        "required": [
          "input",
          "output"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringfalsenonenone
messages[MessageInput]falsenonenone
metadataMetadatafalsenonenone
namestringfalsenonenone

UpdateThreadResponseContent

{
  "properties": {
    "alias": {
      "type": "string"
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "metadata": {
      "additionalProperties": {},
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "thread_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "created_at",
    "created_by",
    "metadata",
    "name",
    "organization_id",
    "thread_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
aliasstringtruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
metadataMetadatatruenonenone
namestringtruenonenone
organization_idstringtruenonenone
thread_idstringtruenonenone
updated_atstring(date-time)truenonenone

UpdateToolRequestContent

{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "description": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "tool_config_file": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
codeToolCodefalsenonenone
descriptionstringfalsenonenone
env_vars[EnvVar]falsenonenone
namestringfalsenonenone
tool_config_filestringfalsenonenone

UpdateToolResponseContent

{
  "properties": {
    "code": {
      "oneOf": [
        {
          "properties": {
            "github": {
              "properties": {
                "name": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "owner": {
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "push": {
                  "properties": {
                    "branch": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    },
                    "tag": {
                      "maxLength": 200,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "branch"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "name",
                "owner",
                "push"
              ],
              "type": "object"
            }
          },
          "required": [
            "github"
          ],
          "title": "github",
          "type": "object"
        },
        {
          "properties": {
            "data_lake": {
              "properties": {
                "asset_path": {
                  "type": "string"
                },
                "bucket_id": {
                  "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "asset_path",
                "bucket_id"
              ],
              "type": "object"
            }
          },
          "required": [
            "data_lake"
          ],
          "title": "data_lake",
          "type": "object"
        },
        {
          "properties": {
            "default": {
              "type": "object"
            }
          },
          "required": [
            "default"
          ],
          "title": "default",
          "type": "object"
        }
      ]
    },
    "created_at": {
      "format": "date-time",
      "type": "string"
    },
    "created_by": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "env_vars": {
      "items": {
        "properties": {
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "secret_ref",
              "manual"
            ],
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "latest_deployment_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "organization_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "tool_config_file": {
      "type": "string"
    },
    "tool_id": {
      "pattern": "^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$",
      "type": "string"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "code",
    "created_at",
    "created_by",
    "description",
    "env_vars",
    "latest_deployment_id",
    "name",
    "organization_id",
    "tool_id",
    "updated_at"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
codeToolCodetruenonenone
created_atstring(date-time)truenonenone
created_bystringtruenonenone
descriptionstringtruenonenone
env_vars[EnvVar]truenonenone
latest_deployment_idstringtruenonenone
namestringtruenonenone
organization_idstringtruenonenone
tool_config_filestringfalsenonenone
tool_idstringtruenonenone
updated_atstring(date-time)truenonenone

UserDetail

{
  "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"
}

Properties

NameTypeRequiredRestrictionsDescription
created_atstring(date-time)truenonenone
emailstringtruenonenone
namestringfalsenonenone
organizations[string]truenonenone
updated_atstring(date-time)truenonenone
user_idstringtruenonenone

WebhookDetail

{
  "properties": {
    "disable_api_key_param": {
      "type": "boolean"
    },
    "integration_endpoint": {
      "type": "string"
    }
  },
  "required": [
    "disable_api_key_param",
    "integration_endpoint"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
disable_api_key_parambooleantruenonenone
integration_endpointstringtruenonenone

WebhookInput

{
  "properties": {
    "disable_api_key_param": {
      "type": "boolean"
    }
  },
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
disable_api_key_parambooleanfalsenonenone

WebscraperDetail

{
  "properties": {
    "urls": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "urls"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
urls[string]truenonenone

WebscraperInput

{
  "properties": {
    "urls": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "urls"
  ],
  "type": "object"
}

Properties

NameTypeRequiredRestrictionsDescription
urls[string]truenonenone

Could this page be better? Report a problem or suggest an addition!