Tray.ai

Tray.ai Authentications API

Create, retrieve, and delete third-party service authentications that power Tray connectors (e.g., Salesforce, Slack).

Documentation GitHub OpenAPI

Operations 16

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 /graphql#createUserAuthentication Create a third-party auth for an embedded user · Tray.ai Create User Authentication #

Ask an LLM

“How do I store an end user's third-party credentials so a solution instance can use them?”

“Does the createUserAuthentication GraphQL mutation return an authId I can pass to solution instances?”

Tell an agent

Run the createUserAuthentication GraphQL mutation with variables {variables} for my end user.

Send GraphQL mutation {mutation} to add a service authentication and give me back the authId.

POST /graphql#getAuthentications Query authentications through GraphQL · Tray.ai Get Authentications #

Ask an LLM

“With a master token, does the getAuthentications GraphQL query return every user's authentications?”

“Can a user token query only that user's own third-party authentications over GraphQL?”

Tell an agent

Run the getAuthentications GraphQL query {query} and list the results.

Query GraphQL for authentications scoped to the current user token.

POST /graphql#deleteAuthentication Delete an authentication with a GraphQL mutation · Tray.ai Delete Authentication #

Ask an LLM

“Which token does the GraphQL delete-authentication mutation require?”

“Can I revoke an embedded user's stored service credentials through the GraphQL API?”

Tell an agent destructive · confirm first

Run the GraphQL delete-authentication mutation for auth {auth} with the user token.

Send GraphQL mutation {mutation} to remove a user's third-party authentication.

POST / Get user authentications from the embedded root endpoint · Get user authentications (user/master token) #

Ask an LLM

“What does the embedded API root return when I post a get-authentications query with a user or master token?”

“Can I fetch authentications by posting to the root of the Tray Embedded endpoint?”

Tell an agent

Post to the embedded root endpoint to get user authentications, filtered by {variables}.

Fetch authentications from the embedded root endpoint using my master token.

POST / Create user auth via the embedded root endpoint · Create user Auth (user/master token) #

Ask an LLM

“Can I create a user auth by posting to the embedded root endpoint with either a user or master token?”

“Which embedded root call adds new service credentials for an end user?”

Tell an agent

Post a create-user-auth call to the embedded root with variables {variables}.

Add a user auth through the embedded root endpoint using my master token.

POST / Delete user auth via the embedded root endpoint · Delete user Auth (user/master token) #

Ask an LLM

“Is there an embedded root call that deletes a user auth with a user or master token?”

“Can a master token remove an end user's auth by posting to the embedded root endpoint?”

Tell an agent destructive · confirm first

Post a delete-user-auth call to the embedded root for auth {variables}.

Remove a user auth through the embedded root endpoint with my master token.

GET /authentications List authentications on the unversioned endpoint · Tray.ai List Authentications #

Ask an LLM

“Which authentications belong to my user or organization on the plain /authentications endpoint?”

“Can I see every saved service authentication in my Tray organization?”

Tell an agent

List all authentications for my organization from the unversioned authentications endpoint.

Show the service authentications tied to my account.

POST /authentications Create an authentication for Call Connector · Tray.ai Create Authentication #

Ask an LLM

“How do I create an authentication I can then use with the Call Connector endpoint?”

“What does the unversioned create-authentication call need besides a service environment id?”

Tell an agent

Create an authentication named {name} for service environment {environment} on the unversioned endpoint.

Save credentials {credentials} as auth {name} for environment {environment} to use with Call Connector.

GET /authentications/{authenticationId} Get authentication metadata by id · Tray.ai Get Authentication #

Ask an LLM

“What scopes and service environment does a given authentication have?”

“Can I look up an authentication's name and metadata on the unversioned endpoint?”

Tell an agent

Show the metadata for authentication {auth} from the unversioned authentications endpoint.

Get the scopes and serviceEnvironmentId of auth {auth}.

DELETE /authentications/{authenticationId} Delete an authentication by id (unversioned) · Tray.ai Delete Authentication #

Ask an LLM

“Can I delete an authentication by id with a plain DELETE on /authentications?”

“What removes a stored credential from the unversioned authentications resource?”

Tell an agent destructive · confirm first

Delete authentication {auth} using the unversioned authentications endpoint.

Remove stored credential {auth} from /authentications.

POST /core/v1/authentications Create an authentication with core v1 · Create Authentication #

Ask an LLM

“Can a core v1 authentication be tied to an on-prem agent group?”

“How do I create an authentication with specific scopes through the core v1 API?”

Tell an agent

Create core v1 authentication {name} for service environment {environment} with scopes {scopes}.

Create core v1 auth {name} for environment {environment} routed through on-prem agent group {agent_group}.

GET /core/v1/authentications/{authentication-id} Get a core v1 authentication by id · Get Authentication #

Ask an LLM

“What does the core v1 API return for a single authentication id?”

“Which details of a core v1 authentication can I read without the credentials?”

Tell an agent

Get core v1 authentication {auth}.

Show the core v1 record for authentication {auth} without its secrets.

PUT /core/v1/authentications/{authentication-id} Update an authentication's credentials · Update Authentication #

Ask an LLM

“How do I rotate the credentials on an existing authentication?”

“Can I rename an authentication or change its scopes after creating it?”

Tell an agent

Update authentication {auth} with new credentials {credentials} and name {name}.

Change the scopes on authentication {auth} to {scopes}, keeping name {name} and credentials {credentials}.

DELETE /core/v1/authentications/{authentication-id} Delete a core v1 authentication · Delete Authentication #

Ask an LLM

“Can I delete an authentication through the core v1 API?”

“Which core v1 call permanently removes an authentication by id?”

Tell an agent destructive · confirm first

Delete core v1 authentication {auth}.

Permanently remove auth {auth} via core v1.

GET /core/v1/authentications/{authentication-id}/full Get an authentication including its credentials · Get Full Authentication #

Ask an LLM

“Can I retrieve the full authentication, including credentials, for a given id?”

“Is there a way to force an OAuth token refresh when reading an authentication?”

Tell an agent

Get the full authentication {auth} including its credentials.

Fetch full auth {auth} and force a token refresh ({force_refresh}).

GET /core/v1/services/{service-name}/versions/{service-version}/environments List a service's environments · List Service Environments #

Ask an LLM

“Where do I find the serviceEnvironmentId needed to create an authentication?”

“Which environments does a given service version offer?”

Tell an agent

List the environments for service {service} version {version}.

Find the service environment ids for {service} at version {version}.

Tray.ai Authentications API

Operations 16

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification