Tray.ai

Tray.ai Users API

Manage external users of your embedded application. Requires a master token for most operations.

Documentation GitHub OpenAPI

Business capability

Operations 19

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 Create an external user for embedded · Tray.ai Create External User #

Ask an LLM

“How do I add one of my customers as an external user with the GraphQL createExternalUser mutation?”

“Can I mark a new external user as a test user so they are excluded from billing?”

Tell an agent

Run the createExternalUser GraphQL mutation with name and externalUserId in {variables}.

Send GraphQL mutation {mutation} to create an external test user.

POST /graphql#getUsers Query external users via GraphQL · Tray.ai Get Users #

Ask an LLM

“Which external users exist in my embedded application, queried over GraphQL?”

“Does the GraphQL getUsers query return a pagination cursor?”

Tell an agent

Run the getUsers GraphQL query {query} with my master token.

Query GraphQL for external users after cursor {variables}.

POST /graphql#updateExternalUser Update an external user's properties · Tray.ai Update External User #

Ask an LLM

“Can I flag an existing external user as a test user after creating them?”

“Which GraphQL mutation changes an external user's properties?”

Tell an agent

Run the updateExternalUser GraphQL mutation with {variables}.

Send GraphQL mutation {mutation} to mark an external user as a test user.

POST /graphql#removeUser Remove an external user and their data · Tray.ai Remove User #

Ask an LLM

“Does removing an external user with the GraphQL removeUser mutation also delete their solution instances and authentications?”

“How do I offboard a customer from my embedded application completely?”

Tell an agent destructive · confirm first

Run the removeUser GraphQL mutation for external user {user}.

Send GraphQL mutation {mutation} to remove an external user with all their instances and auths.

POST / Get users via the embedded root endpoint · Get users (master token) #

Ask an LLM

“Can I list embedded users by posting to the embedded root endpoint with a master token?”

“Which embedded root call returns my end users?”

Tell an agent

Post a get-users request to the embedded root with {variables}.

Fetch end users through the embedded root endpoint using my master token.

POST / Create an end user via the embedded root · Create new user (master token) #

Ask an LLM

“Is there an embedded root call that creates a new end user with a master token?”

“Which master-token request posted to the embedded root adds an end user?”

Tell an agent

Post a create-new-user request to the embedded root with {variables}.

Add a new end user through the embedded root endpoint.

POST / Create a user token via the embedded root · Create user token (master token) #

Ask an LLM

“Can I mint a user token by posting to the embedded root with a master token?”

“Which embedded root call gives me a bearer token scoped to one end user?”

Tell an agent

Post a create-user-token request to the embedded root for user {variables}.

Mint a user-scoped token through the embedded root endpoint.

POST / Create an auth code for the config wizard · Create Auth/Config dialog Authorization Code (master token) #

Ask an LLM

“How do I get an authorization code to open the Auth or Config dialog for an end user?”

“What do I need before showing the configuration wizard to a user?”

Tell an agent

Create a config wizard authorization code for user {variables}.

Generate an Auth/Config dialog code using my master token.

POST / Update an end user via the embedded root · Update user (master token) #

Ask an LLM

“Can I update an end user by posting to the embedded root with a master token?”

“Which embedded root call edits an existing end user?”

Tell an agent

Post an update-user request to the embedded root with {variables}.

Edit an end user through the embedded root endpoint.

POST / Delete an end user via the embedded root · Delete user (master token) #

Ask an LLM

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

“Which master-token request posted to the embedded root deletes a user?”

Tell an agent destructive · confirm first

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

Delete an end user through the embedded root endpoint.

GET /users List organization users with roles (unversioned) · Tray.ai List Users #

Ask an LLM

“Who are the members of my Tray organization and what roles do they have?”

“Can I see members' emails and roles on the unversioned /users endpoint?”

Tell an agent

List users in my organization from the unversioned users endpoint.

Show each organization member's name, email and role.

POST /users/invite Invite a user by email (unversioned) · Tray.ai Invite User #

Ask an LLM

“How do I invite a teammate to my organization by email?”

“Can an invite on the unversioned endpoint also put the person in a specific workspace?”

Tell an agent

Invite {email} to the organization with role {role}.

Send an unversioned invite to {email} for workspace {workspace}.

POST /core/v1/invites Invite a user to the organization (core v1) · Invite User to Organization Workspace #

Ask an LLM

“Does a core v1 invite email the person a link to create their account?”

“Which organization role id do I need to invite someone through core v1?”

Tell an agent

Send a core v1 invite to {email} with organization role {role}.

Email {email} an account-creation link and give them role {role}.

GET /core/v1/roles List organization roles · List Organization Roles #

Ask an LLM

“Which organization roles can I assign to users?”

“Where do I find the role id to give a new user?”

Tell an agent

List the roles in my organization.

Show the first {count} organization roles.

GET /core/v1/users List or find organization users (core v1) · List Users #

Ask an LLM

“Can I look up an organization user by email address?”

“How many users are in my organization, according to core v1?”

Tell an agent

Find the organization user with email {email}.

List organization users via core v1, {count} per page.

POST /core/v1/users Create an organization user without an invite · Create User #

Ask an LLM

“How do I add a user when my organization uses SSO and I don't want an invite email sent?”

“Can I create an organization user directly with a name, email and role?”

Tell an agent

Create organization user {name} with email {email} and role {role}, no invitation.

Add SSO user {email} named {name} as role {role}.

GET /core/v1/users/{userId} Get an organization user by id · Get User #

Ask an LLM

“What details does Tray hold for a specific organization user?”

“Can I fetch one user record if I know its id?”

Tell an agent

Get organization user {user}.

Show the profile of user id {user}.

DELETE /core/v1/users/{userId} Delete an organization user · Delete User #

Ask an LLM

“Can I delete someone from my organization by user id?”

“Which call removes an organization user entirely?”

Tell an agent destructive · confirm first

Delete organization user {user}.

Remove user {user} from the organization entirely.

PUT /core/v1/users/{userId}/roles Change a user's organization role · Update User Role #

Ask an LLM

“How do I promote or demote a user's role across the organization?”

“Can I change someone's organization-level role without touching workspace roles?”

Tell an agent

Change the organization role of user {user} to {role}.

Set user {user}'s org-wide role to {role}.

Tray.ai Users API

Operations 19

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