Tray.ai

Tray.ai Projects API

Manage projects and solutions for environment promotion, including creating, exporting, and importing project versions.

GitHub OpenAPI

Operations 11

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 / Import a project via the embedded root endpoint · Import Project (master token) #
Ask an LLM
“Can I import a project by posting to the embedded root endpoint with a master token?”
“Which embedded root call loads a previously exported project into my account?”
Tell an agent
Post an import-project request to the embedded root with variables {variables}.
Import a project through the embedded root endpoint using my master token.
POST / Export a project via the embedded root endpoint · Export Project (master token) #
Ask an LLM
“Is there an embedded root call that exports a whole project with a master token?”
“How can I pull a project export out through the embedded root endpoint?”
Tell an agent
Post an export-project request to the embedded root for project {variables}.
Export the project through the embedded root endpoint with my master token.
POST / Export a project's config via the embedded root · Export Project Config (master token) #
Ask an LLM
“Can I export only a project's configuration, not the whole project?”
“Which embedded root call returns the config of a project?”
Tell an agent
Export the config for project {variables} through the embedded root endpoint.
Pull just the project configuration using my master token.
POST /projects/{projectId}/export Export a project for environment promotion · Tray.ai Export Project #
Ask an LLM
“How do I move a project from my staging workspace to production?”
“Can I export a project version by project id to promote it between environments?”
Tell an agent
Export project {project} so I can promote it to production.
Create a promotion export of project {project} from staging.
POST /projects/import Import exported project data into a workspace · Tray.ai Import Project #
Ask an LLM
“Can I import exported project data into a different target workspace?”
“What do I pass to bring a promoted project into production via /projects/import?”
Tell an agent
Import exported project data {data} into workspace {workspace}.
Promote the export {data} into my target workspace.
POST /core/v1/projects/{projectId}/versions/{versionNumber} Save a project version · Create project version #
Ask an LLM
“How do I snapshot a project's current state so I can release or roll back to it later?”
“Can I give a saved project version a title and description?”
Tell an agent
Save project {project} as version {version} titled {title}.
Create version {version} of project {project} called {title} with notes {description}.
GET /core/v1/projects/{projectId}/versions List a project's saved versions · List project versions #
Ask an LLM
“Which saved versions exist for my project?”
“Can I page through a project's version history?”
Tell an agent
List the saved versions of project {project}.
Show the first {count} versions of project {project}.
GET /core/v1/projects/{projectId}/versions/{versionNumber}/export Export a specific project version as JSON · Export project from version #
Ask an LLM
“Can I download the JSON for one particular saved version of a project?”
“What does a saved project version look like when exported?”
Tell an agent
Export version {version} of project {project} as JSON.
Get the JSON of project {project} at saved version {version}.
POST /core/v1/projects/{projectId}/imports/requirements Get the requirements to import a project · Get import requirements #
Ask an LLM
“Which authentications and config mappings will an import need before I run it?”
“What do I have to resolve before importing an exported project?”
Tell an agent
Check what authentications and config project {project} needs to import {export}.
List import requirements for {export} into project {project} with connector mapping {connectors} and service mapping {services}.
POST /core/v1/projects/{projectId}/imports/previews Preview the impact of a project import · Get import preview #
Ask an LLM
“What would change in my project and solution if I applied this import?”
“Can I dry-run a project import before committing it?”
Tell an agent
Preview importing {export} into project {project} with auth resolution {auths}.
Dry-run import of {export} into {project} using connector mapping {connectors} and service mapping {services}.
POST /core/v1/projects/{projectId}/imports Import a project with dependency mappings · Import project #
Ask an LLM
“How do I apply an import to a project with my own config and authentication mappings?”
“Can I override config values when importing into an existing project?”
Tell an agent
Import {export} into project {project}, resolving authentications with {auths}.
Apply the import of {export} to {project} with config override {config}.

Documentation

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

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/openapi/tray-ai-projects-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/json-schema/user.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/json-schema/solution.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/json-schema/solution-instance.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/json-schema/authentication.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/json-structure/tray-ai-solution-instance-structure.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/json-schema/connector.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/json-schema/subscription.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/json-schema/workspace.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/json-structure/tray-ai-connector-structure.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/overlays/tray-ai-projects-overlay.yaml
🔗
PostmanCollection
https://www.postman.com/tray-docs/tray-io-s-public-workspace/collection/uo51x8u/tray-embedded-apis-graphql
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/json-ld/tray-ai-context.jsonld
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/examples/tray-ai-create-solution-instance-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/examples/tray-ai-list-connectors-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/examples/tray-ai-call-connector-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/examples/tray-ai-create-authentication-example.json
🔗
SpectralRuleset
https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/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-projects-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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-projects-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Tray Ai Projects API
  version: 1.0.0
  x-refined-note:
  - x-logo differs across the merged source definitions and was not carried
  description: 'Operations tagged projects across 3 of this provider''s published API definitions: tray-ai-embedded-api-published-openapi.yaml, 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://tray.io/graphql
  description: US
- url: https://eu1.tray.io/graphql
  description: EU
- url: https://ap1.tray.io/graphql
  description: APAC
- 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:


# --- truncated at 32 KB (75 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tray-ai/refs/heads/main/openapi/tray-ai-projects-api-openapi.yml