Tray.ai

Tray.ai Deployments API

Deploy CDK (Connector Development Kit) connectors to the Tray platform.

GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /connectors/{connectorName}/versions/{connectorVersion}/deploy Deploy a CDK connector bundle · Tray.ai Deploy CDK Connector #
Ask an LLM
“How do I deploy a connector I built with the Connector Development Kit?”
“Must the connector name and version match my connector.json when deploying a bundle?”
Tell an agent
Deploy CDK connector {connector} version {version} from bundle {bundle}.
Upload the built bundle for {connector} {version} to Tray.
POST /cdk/v1/deployments/connectors/{connector-name}/versions/{connector-version}/deploy-connector-from-source Deploy a connector from source · Deploy Connector #
Ask an LLM
“Can Tray build and deploy my custom connector straight from source?”
“Which call starts a deployment from source for a connector version?”
Tell an agent
Start a from-source deployment of connector {connector} version {version}.
Kick off deploy-from-source for {connector} {version}.
GET /cdk/v1/deployments/connectors/{connector-name}/versions/{connector-version}/{id} Check a connector deployment's status · Check status #
Ask an LLM
“Has my connector deployment finished yet?”
“What status is a given connector deployment in?”
Tell an agent
Check the status of deployment {deployment} for connector {connector} version {version}.
Tell me whether deployment {deployment} of {connector} {version} succeeded.

Documentation

📖
Documentation
https://tray.ai/documentation/developer/openapi/embeddedapi-introduction/
📖
Documentation
https://tray.ai/documentation/developer/openapi/trayapi/overview/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/tray-ai/openapi/tray-ai-deployments-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/tray-ai/json-schema/user.json
📊
JSONSchema
https://artifacts.apis.io/tray-ai/json-schema/solution.json
📊
JSONSchema
https://artifacts.apis.io/tray-ai/json-schema/solution-instance.json
📊
JSONSchema
https://artifacts.apis.io/tray-ai/json-schema/authentication.json
📊
JSONStructure
https://artifacts.apis.io/tray-ai/json-structure/tray-ai-solution-instance-structure.json
📊
JSONSchema
https://artifacts.apis.io/tray-ai/json-schema/connector.json
📊
JSONSchema
https://artifacts.apis.io/tray-ai/json-schema/subscription.json
📊
JSONSchema
https://artifacts.apis.io/tray-ai/json-schema/workspace.json
📊
JSONStructure
https://artifacts.apis.io/tray-ai/json-structure/tray-ai-connector-structure.json

Other Resources

🔗
Overlay
https://artifacts.apis.io/tray-ai/overlays/tray-ai-deployments-overlay.yaml
🔗
PostmanCollection
https://www.postman.com/tray-docs/tray-io-s-public-workspace/collection/uo51x8u/tray-embedded-apis-graphql
🔗
JSONLD
https://artifacts.apis.io/tray-ai/json-ld/tray-ai-context.jsonld
🔗
Examples
https://artifacts.apis.io/tray-ai/examples/tray-ai-create-solution-instance-example.json
🔗
Examples
https://artifacts.apis.io/tray-ai/examples/tray-ai-list-connectors-example.json
🔗
Examples
https://artifacts.apis.io/tray-ai/examples/tray-ai-call-connector-example.json
🔗
Examples
https://artifacts.apis.io/tray-ai/examples/tray-ai-create-authentication-example.json
🔗
SpectralRuleset
https://artifacts.apis.io/tray-ai/rules/tray-ai-rules.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/tray-ai:tray-ai-deployments-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tray-ai-deployments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Tray Ai Deployments API
  version: 1.0.0
  x-refined-note:
  - x-logo differs across the merged source definitions and was not carried
  description: 'Operations tagged Deployments across 2 of this provider''s published API definitions: tray-ai-platform-api-openapi.yml, tray-ai-platform-api-published-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.tray.io/core/v1
  description: US Region (Default)
- url: https://api.eu1.tray.io/core/v1
  description: EU Region
- url: https://api.ap1.tray.io/core/v1
  description: APAC Region
- url: https://api.tray.io
  description: US
- url: https://api.eu1.tray.io
  description: EU
- url: https://api.ap1.tray.io
  description: APAC
security:
- bearerAuth: []
tags:
- name: Deployments
  description: Deploy CDK (Connector Development Kit) connectors to the Tray platform.
paths:
  /connectors/{connectorName}/versions/{connectorVersion}/deploy:
    post:
      operationId: deployConnector
      summary: Tray.ai Deploy CDK Connector
      description: Deploys a CDK (Connector Development Kit) connector to the Tray platform. The connector name and version must match those defined in connector.json.
      tags:
      - Deployments
      parameters:
      - name: connectorName
        in: path
        required: true
        schema:
          type: string
        description: The name of the CDK connector to deploy
      - name: connectorVersion
        in: path
        required: true
        schema:
          type: string
        description: The version of the CDK connector to deploy
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                connectorBundle:
                  type: string
                  description: The bundled connector code for deployment
      responses:
        '200':
          description: Connector deployed successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  connectorName:
                    type: string
                  connectorVersion:
                    type: string
                  status:
                    type: string
        '400':
          description: Invalid deployment request
        '401':
          $ref: '#/components/responses/Unauthorized'
    servers:
    - url: https://api.tray.io/core/v1
      description: US Region (Default)
    - url: https://api.eu1.tray.io/core/v1
      description: EU Region
    - url: https://api.ap1.tray.io/core/v1
      description: APAC Region
  /cdk/v1/deployments/connectors/{connector-name}/versions/{connector-version}/deploy-connector-from-source:
    post:
      operationId: create-deployment
      summary: Deploy Connector
      description:
        $ref: descriptions/trayapi/endpoints/deployments/createDeployment.md
      tags:
      - Deployments
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: The RBAC token. Follow this [page](https://docs.tray.ai/platform/enterprise-core/organisation-management/api-users-tokens) to know how to generate one.
        example: Bearer 3fd74d349xxxxxxxxxxxxxxxxxxxxxxxxd90df521
      - in: path
        name: connector-name
        required: true
        schema:
          type: string
        description: The hypenated name of the connector being deployed.
        example: my-connector
      - in: path
        name: connector-version
        required: true
        schema:
          type: string
        description: The version of the connector being deployed.
        example: '1.0'
      responses:
        200:
          description: OK - Connector deployment request recieved, your connector deployment will now be in progress unless you recieved `repeatDeployment` with a value of `true` in your response, which indicates a skipped deployment because there is already a deployment in progress for this connector.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeployConnectorFromSourceResponse'
              example:
                id: 3c5exxx-xxxx-xxxx-xxxx-xxxxxxxx2387
                deploymentStatus: Deploying
                connectorName: my-connector
                connectorVersion: '1.0'
        400:
          description: Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
        401:
          description: Unauthorized - Verify the token validity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
        403:
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
        404:
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
        429:
          description: Limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
        500:
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
    servers:
    - url: https://api.tray.io
      description: US
    - url: https://api.eu1.tray.io
      description: EU
    - url: https://api.ap1.tray.io
      description: APAC
  /cdk/v1/deployments/connectors/{connector-name}/versions/{connector-version}/{id}:
    get:
      operationId: get-deployment-status
      summary: Check status
      description:
        $ref: descriptions/trayapi/endpoints/deployments/getDeploymentStatus.md
      tags:
      - Deployments
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: The RBAC token. Follow this [page](https://docs.tray.ai/platform/enterprise-core/organisation-management/api-users-tokens) to know how to generate one.
        example: Bearer 3fd74d349xxxxxxxxxxxxxxxxxxxxxxxxd90df521
      - in: path
        name: connector-name
        required: true
        schema:
          type: string
        description: The hypenated name of the connector being deployed.
        example: my-connector
      - in: path
        name: connector-version
        required: true
        schema:
          type: string
        description: The version of the connector being deployed.
        example: '1.0'
      - in: path
        name: id
        required: true
        schema:
          type: string
        description: The deployment id given to you in the response from the original deployment request. <br /> You can also pass `latest` to retrive status of last deployment of the connector.
        examples:
          For status of a particular deployment:
            value: 3c5exxx-xxxx-xxxx-xxxx-xxxxxxxx2387
          For status of the latest deployment:
            value: latest
      responses:
        200:
          description: OK - Returns the deployment status for the connector version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetConnectorDeploymentResponse'
              example:
                id: 3c5exxx-xxxx-xxxx-xxxx-xxxxxxxx2387
                deploymentStatus: Deploying
                connectorName: my-connector
                connectorVersion: '1.0'
        400:
          description: Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
        401:
          description: Unauthorized - Verify the token validity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
        403:
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
        404:
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
        429:
          description: Limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
        500:
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailed'
    servers:
    - url: https://api.tray.io
      description: US
    - url: https://api.eu1.tray.io
      description: EU
    - url: https://api.ap1.tray.io
      description: APAC
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error type
        message:
          type: string
          description: Human-readable error message
        statusCode:
          type: integer
          description: HTTP status code
    GetConnectorDeploymentResponse:
      type: object
      properties:
        id:
          type: string
          description: The deployment id of the connector deployment request.
        deploymentStatus:
          type: string
          description: The status of the deployment request.
          enum:
          - Deployed
          - Failed
          - Deploying
        connectorName:
          type: string
          description: The name of the connector being deployed.
        connectorVersion:
          type: string
          description: The version of the connector being deployed.
    DeployConnectorFromSourceResponse:
      type: object
      properties:
        id:
          type: string
          description: The deployment id of the connector deployment request.
        repeatDeployment:
          type: boolean
          description: Indicates that the deployment request was skipped because there is already a deployment in progress for this connector.
        deploymentStatus:
          type: string
          description: The status of the deployment request.
          enum:
          - Deployed
          - Failed
          - Deploying
        connectorName:
          type: string
          description: The name of the connector being deployed.
        connectorVersion:
          type: string
          description: The version of the connector being deployed.
    RequestFailed:
      type: object
      properties:
        message:
          type: string
        code:
          type: string
  responses:
    Unauthorized:
      description: Authentication failed. The bearer token is missing, invalid, or does not have sufficient permissions for the requested operation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Bearer token authentication. Use a master token for admin operations or a user token for user-scoped operations. Tokens are obtained from the Tray platform settings or via the Embedded API authorize mutation.
x-refined-from:
- tray-ai-platform-api-openapi.yml
- tray-ai-platform-api-published-openapi.yaml