/
AG
agentsky
Search skmtc…
⌘K
Docs
Sign in
Docs
History
Schema
Generate
Filter operations
Account
1
agents
1
api_keys
6
Arena
8
artifacts
60
branding
3
browser_profiles
6
catalog
25
channels
31
Channels
2
connectors
17
get
/connectors/apps
Deprecated: use GET /plugins?view=discover&source=app. List the apps a person can connect [read]
get
/connectors/apps/{slug}/logo
An app's mark [public]
get
/connectors/connections
Deprecated: use GET /plugins?view=yours&source=app&include=connections (include=granted for granted=true). List the caller's connections [read]
post
/connectors/connections
Deprecated: use POST /plugins/app:{app}/add. Start connecting an app [write]
post
/connectors/connections/complete
Record a finished authorization [write]
get
/connectors/connections/{id}
Deprecated: use GET /plugins/app:{app}. Get one of the caller's connections [read]
delete
/connectors/connections/{id}
Deprecated: use DELETE /plugins/app:{app}?connection_id={id}&disconnect=true. Disconnect one of the caller's connections [write]
get
/connectors/connections/{id}/grants
Deprecated: use GET /plugins/app:{app}/share?connection_id={id}. List who may call through one of the caller's connections with a key [read]
post
/connectors/connections/{id}/grants
Deprecated: use POST /plugins/app:{app}/share {workspace, api_key | all_api_keys: true}. Let a workspace's keys call through one of the caller's connections [write]
delete
/connectors/connections/{id}/grants
Deprecated: use DELETE /plugins/app:{app}/share?workspace=&api_key= (or all_api_keys=true). Take a grant back [write]
post
/connectors/proxy
Deprecated: use POST /plugins/app:{app}/call. Call a third-party API through a granted connection [write]
get
/connectors/github/repos
List the repositories the caller's GitHub connection can reach [read]
get
/connectors/github/pulls
Find the open pull request for a branch through the caller's GitHub connection [read]
post
/connectors/links
Deprecated: use POST /plugins/app:{app}/add {task_id, request_id}. Make a link to connect the app a task is waiting on [write]
get
/connectors/links/{token}
The page a connect link opens
post
/connectors/links/{token}
Continue from a connect link to the app's authorization
get
/connectors/links/{token}/done
Where the app's authorization returns for a connect link
Credit campaigns
4
Desktop
23
environments
11
Events
4
files
9
Gateway
1
harnesses
13
help
1
Memory
4
notifications
5
oauth_clients
6
oauth_grants
2
partner
8
sessions
10
tasks
15
Tasks
2
trace-library
4
traces
5
universes
1
vaults
10
worker-pools
7
workspace-connectors
9
workspace-describe
1
workspace-identity
3
get
/billing
Read credit balance and card availability [read]
post
/billing/card-setup
Start saving a payment card [write]
get
/billing/auto-topup
Read auto top-up settings [read]
patch
/billing/auto-topup
Change auto top-up settings [write]
post
/billing/topups
Buy credit for your own balance with your saved card [write]
post
/billing/credit-invites/claim
Claim a credit invite link for your own balance [write]
get
/billing/usage
Account-wide usage across sessions and API keys [read]
get
/billing/usage/export
Download every usage record in a range as CSV or JSONL [read]
get
/billing/usage/requests
Per-request history of your developer API keys [read]
get
/billing/coding-plan
Read your coding plan [read]
post
/billing/coding-plan
Join the coding plan, or change your monthly amount [write]
delete
/billing/coding-plan
Stop your coding plan renewing [write]
get
/billing/referral-links
Your customer discount links and what they earned [read]
post
/billing/referral-links
Create a customer discount link [write]
post
/billing/referral-links/{id}/disable
Disable one of your customer discount links [write]
get
/meeting-recordings
List the caller's meeting recordings [read]
post
/meeting-recordings
Report a finished meeting recording for metering [write]
get
/meeting-recordings/{id}
Get one meeting recording [read]
get
/preferences
The caller's platform preferences [read]
patch
/preferences
Update the caller's platform preferences [write]
post
/runs
Run a product [write]
get
/runs/{id}
Read a Run [read]
get
/runs/{id}/events
Read durable Run events, or observe with Accept: text/event-stream [read]
post
/runs/{id}/events
Target steering or an interrupt to this Run [write]
get
/whoami
Caller identity, resolved universe, effective scopes [read]
get
/universes
List universes [read]
post
/universes
Create a universe [write, personal tokens only]
get
/universes/{slug}
Universe detail [read]
delete
/universes/{slug}
Permanently delete a workspace and everything in it [write, owner]
patch
/universes/{slug}
Rename a workspace or enable Google Limited Use [write, owner]
get
/universes/{slug}/deletion
What deleting the workspace would remove, and whether it can be deleted [read, owner]
get
/universes/{slug}/members
People in the workspace and, for owners and admins, waiting invitations [read]
delete
/universes/{slug}/members/{userId}
Remove a non-owner from the workspace, or leave it [write]
patch
/universes/{slug}/members/{userId}
Make someone an admin or a member [write, owner]
get
/universes/{slug}/agents
The agents this workspace chose from the catalog [read]
get
/universes/{slug}/agents/{handle}
One agent the workspace chose from the catalog [read]
put
/universes/{slug}/agents/{handle}
Install an agent from the catalog, or change its default model or enabled state [write, owner or admin]
delete
/universes/{slug}/agents/{handle}
Remove an agent from the workspace's choices [write, owner or admin]
post
/universes/{slug}/invites
Add people to the workspace by email [write, owner or admin]
get
/invites/{token}
What an invitation link offers the signed-in person [read]
post
/invites/{token}
Join the workspace through an invitation link [write]
get
/invites/{token}/public
Public preview of an invitation — workspace name and inviter, no auth required
delete
/universes/{slug}/invites/{inviteId}
Withdraw an invitation that has not been taken up [write, owner or admin]
get
/universes/{slug}/wallet
A workspace's own wallet: balance, each member's spending this month, limits, members waiting for a higher limit [read, owner or admin]
post
/universes/{slug}/wallet
Give the workspace a wallet of its own [write, owner or admin]
post
/universes/{slug}/wallet/transfers
Move some of your own purchased credit into the workspace wallet [write, owner or admin]
post
/universes/{slug}/wallet/topups
Buy credit for the workspace wallet with your own saved card [write, owner or admin]
post
/universes/{slug}/wallet/limit-requests/{requestId}
Answer a member's request for a higher monthly limit [write, owner or admin]
put
/universes/{slug}/wallet/limits/{userId}
Set or clear a member's monthly limit on workspace wallet spending [write, owner or admin]
get
/universes/{slug}/connections
Deprecated: use GET /plugins?view=yours&source=app. Connected apps people share with the workspace, and the ones it owns [read]
post
/universes/{slug}/connections
Share one of your own connections with the workspace, or start connecting an app for it [write]
post
/universes/{slug}/connections/complete
Record an app connected for the workspace itself [write, owner or admin]
delete
/universes/{slug}/connections/{connectionId}
Deprecated: use DELETE /plugins/app:{app}/share?workspace={slug}&connection_id={connectionId}. Stop sharing a connection with the workspace [write, the sharer, owner or admin]
get
/shared-connections
Deprecated: use GET /plugins?view=yours&source=app&include=shared. Everything you share with a workspace, and the calls made through each [read]
get
/universes/{slug}/keys
Keys that belong to the workspace [read, owner or admin]
post
/universes/{slug}/keys
Make a workspace key [admin, owner or admin]
delete
/universes/{slug}/keys/{keyId}
Revoke a workspace key [admin, owner or admin]
get
/universes/{slug}/hooks
Get workspace shared hooks [read]
put
/universes/{slug}/hooks
Replace workspace shared hooks (owner only) [write]
get
/universes/{slug}/policies
List workspace policy rules [read]
post
/universes/{slug}/policies
Create a workspace policy rule (owner only) [write]
get
/universes/{slug}/policies/{ruleId}
Get a workspace policy rule [read]
delete
/universes/{slug}/policies/{ruleId}
Delete a workspace policy rule (owner only) [write]
patch
/universes/{slug}/policies/{ruleId}
Update a workspace policy rule (owner only) [write]
get
/agents
List agents in the resolved universe [read]
post
/agents
Create an agent [write]
get
/agents/{id}
Agent detail [read]
delete
/agents/{id}
Delete the agent — only with zero live sessions (409 agent_has_sessions) [admin]
patch
/agents/{id}
Update displayName / capabilities / metadata [write]
post
/agents/{id}/archive
Archive the agent — read-only, sessions keep running, new sessions rejected [admin]
post
/agents/{id}/invite
Invite the agent into a team chat: with conversation_id it joins that conversation's roster (RFC-0151); without, returns the Slack install URL [write]
put
/agents/{id}/prompt
Save the user prompt layer; applies to sessions started after the save [write]
get
/agents/{id}/prompt/versions
Prompt version history [read]
get
/agents/{id}/secrets
Declared secret keys + set/unset — never values [read]
put
/agents/{id}/secrets/{key}
Set a declared secret's value (write-only) [write]
delete
/agents/{id}/secrets/{key}
Unset a secret [write]
put
/agents/{id}/avatar
Upload a custom PNG/JPEG avatar for the agent (≤ 1 MB) [write]
delete
/agents/{id}/avatar
Remove the custom avatar and revert to the engine-mark / sky-avatar fallback [write]
get
/external_accounts
List the workspace's accounts at outside vendors — never credentials [read]
post
/external_accounts
Connect a vendor account, or replace the credential of the one with the same vendor and label [write]
delete
/external_accounts/{id}
Disconnect an account; a later task that needs it asks for it again [write]
get
/external_accounts/{id}/usage
Which agents and tasks ran on a vendor account [read]
get
/model-subscriptions
List connected model subscriptions — metadata only, never credentials [read]
post
/model-subscriptions
Add a separate subscription account [write]
put
/model-subscriptions/{provider}
Connect or replace a subscription credential (write-only) [write]
delete
/model-subscriptions/{provider}
Disconnect — affected agents keep their pointer and fail until reconnected or switched [write]
patch
/model-subscriptions/{provider}
Update useForNewAgents / label [write]
post
/model-subscriptions/{provider}/logins
Start a browser sign-in to a model plan [write]
get
/model-subscriptions/{provider}/logins/{loginId}
Advance a browser sign-in; stores the subscription when it finishes [write]
delete
/model-subscriptions/{provider}/logins/{loginId}
Abandon a browser sign-in and free its sandbox [write]
post
/model-subscriptions/{provider}/logins/{loginId}/code
Submit the code the provider's sign-in page shows [write]
get
/model-subscriptions/{provider}/usage
Plan allowance left on a connected account [read]
post
/model-subscriptions/{provider}/switch-to-credits
Move the agents on a subscription account onto platform credits [write]
get
/capabilities
Deprecated: use GET /plugins?view=yours. Everything your agents can use, in one list [read]
get
/plugins
Everything agents can use, as one Plugin list; or the installed plugin bundles [read]
post
/plugins
Install a plugin bundle, add a custom MCP server, or upload a skill [write]
get
/plugins/{name}
One plugin by id [read]
delete
/plugins/{name}
Remove a plugin or disconnect it [write]
patch
/plugins/{name}
Switch an installed plugin on or off [write]
post
/plugins/{name}/add
Add a plugin or connect it [write]
connectors
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to Deprecated: use GET /plugins/app:{app}/share?connection_id={id}. List who may call through one of the caller's connections with a key [read]
get
/connectors/connections/{id}/grants
Nov 2, 2026
e5e8f0229a99
Revision changes
info
endpoint added