Account
Endpoints for discovering what the current account has access to.
Resolve a bearer token to a user, list the external applications connected to the account, and manage shared accounts and stacks.
Shared account and stack share schemas
Resolves a bearer token to the user it authenticates as.
Token identity.
User this token authenticates as.
5e58483b68b52e5827d56a86Unauthorized. The request lacks a valid bearer token, or the provided token failed to authenticate.
Note: the 401 response is produced by the auth middleware before the
request reaches the endpoint handler, so it does not follow the
standard {errors: [...]} envelope. Instead the body is a bare
{message: string} object with no code, no errors array. Callers
handling 401s should key off the HTTP status and the message string,
not try to destructure an errors[].
GET /v1/tokenInfo HTTP/1.1
Host: api.integrator.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"_userId": "5e58483b68b52e5827d56a86"
}Returns every external application that has at least one connection in the account, grouped with summaries of those connections.
Applications in use, each with its connection references.
List of external applications that have at least one connection in the account.
Unauthorized. The request lacks a valid bearer token, or the provided token failed to authenticate.
Note: the 401 response is produced by the auth middleware before the
request reaches the endpoint handler, so it does not follow the
standard {errors: [...]} envelope. Instead the body is a bare
{message: string} object with no code, no errors array. Callers
handling 401s should key off the HTTP status and the message string,
not try to destructure an errors[].
GET /v1/applications HTTP/1.1
Host: api.integrator.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"applications": [
{
"_id": "netsuite",
"refs": {
"connections": [
{
"_id": "61f92026dd053843b5d72350",
"createdAt": "2022-01-31T17:05:42.000Z"
}
]
}
},
{
"_id": "shopify",
"refs": {
"connections": [
{
"_id": "62a80ef9ea2474232730eede",
"createdAt": "2022-06-13T21:44:41.000Z"
}
]
}
},
{
"_id": "3mftp_tp",
"refs": {
"connections": [
{
"_id": "68efa98330271865e67477de",
"createdAt": "2025-10-15T14:02:43.371Z"
}
]
}
}
]
}Returns every account that other users have shared with the current user. This is the inverse of GET /v1/ashares, which lists users who have access to your account.
Array of shared-account entries.
A share record granting the current user access to another user's account.
This is the inverse of GET /v1/ashares: here the current user is the
recipient, and ownerUser is who shared.
Unique identifier for this share record, not a user or account ID.
612345abcdef6789012345abWhen true, the current user has accepted the invitation. Unaccepted shares appear in the list but cannot be acted on.
Account-wide permission level. Mutually exclusive with
integrationAccessLevel when set to administrator or manage.
When set to monitor, per-integration overrides may elevate
specific integrations to manage. Absent when the user has
only per-integration access.
Timestamp when this share record was last updated.
2025-11-15T12:00:00.000ZTimestamp when this share record was created.
2025-11-15T12:00:00.000ZNo accounts are shared with the current user.
Unauthorized. The request lacks a valid bearer token, or the provided token failed to authenticate.
Note: the 401 response is produced by the auth middleware before the
request reaches the endpoint handler, so it does not follow the
standard {errors: [...]} envelope. Instead the body is a bare
{message: string} object with no code, no errors array. Callers
handling 401s should key off the HTTP status and the message string,
not try to destructure an errors[].
GET /v1/shared/ashares HTTP/1.1
Host: api.integrator.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"_id": "612345abcdef6789012345ab",
"accepted": true,
"accessLevel": "administrator",
"integrationAccessLevel": [],
"ownerUser": {
"_id": "5ab979f5038e555b2a95c385",
"name": "Account Owner",
"email": "owner@example.com"
},
"lastModified": "2025-11-15T12:00:00.000Z",
"createdAt": "2025-11-15T12:00:00.000Z"
},
{
"_id": "71a234bcdef5678901234567",
"accepted": true,
"accessLevel": "monitor",
"integrationAccessLevel": [
{
"_integrationId": "60f1a2b3c4d5e6f7a8b9c0d1",
"accessLevel": "manage"
}
],
"ownerUser": {
"_id": "62b456e7890abcdef1234567",
"name": "Partner Admin",
"email": "partner@example.com"
},
"lastModified": "2026-02-10T08:30:00.000Z",
"createdAt": "2026-01-05T14:00:00.000Z"
}
]Returns stack-share records for the current user, including share status, the user who shared, and a stack summary. To list usable stacks directly, use GET /v1/shared/stacks.
Array of stack share entries.
A share record granting the current user access to another user's stack.
The _id here is the share record — the stack's own ID is in stack._id.
Unique identifier for the share record, not the stack itself.
69f53622861a268851c836d0When true, the current user has accepted the invitation. The stack cannot be used until accepted.
No stacks are shared with the current user.
Unauthorized. The request lacks a valid bearer token, or the provided token failed to authenticate.
Note: the 401 response is produced by the auth middleware before the
request reaches the endpoint handler, so it does not follow the
standard {errors: [...]} envelope. Instead the body is a bare
{message: string} object with no code, no errors array. Callers
handling 401s should key off the HTTP status and the message string,
not try to destructure an errors[].
GET /v1/shared/sshares HTTP/1.1
Host: api.integrator.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"_id": "69f53622861a268851c836d0",
"accepted": true,
"ownerUser": {
"_id": "69790a36cf9d563e23345f49",
"email": "partner@example.com",
"name": "Partner User"
},
"stack": {
"_id": "69f536192e7966f4032f2299",
"name": "sample",
"type": "server"
}
}
]Returns every stack the current account can use — both owned and accepted shared stacks. For share metadata (who shared, acceptance status), use GET /v1/shared/sshares.
Array of stacks (may be empty).
Summary of a stack available to the account, returned by
GET /v1/shared/stacks. For the full stack resource (CRUD,
dependencies), use GET /v1/stacks/{_id}.
Unique identifier for this stack.
69f536192e7966f4032f2299Display name shown in the UI when selecting a stack.
Production On-Prem AgentExecution environment type that determines which configuration block is present.
Unauthorized. The request lacks a valid bearer token, or the provided token failed to authenticate.
Note: the 401 response is produced by the auth middleware before the
request reaches the endpoint handler, so it does not follow the
standard {errors: [...]} envelope. Instead the body is a bare
{message: string} object with no code, no errors array. Callers
handling 401s should key off the HTTP status and the message string,
not try to destructure an errors[].
GET /v1/shared/stacks HTTP/1.1
Host: api.integrator.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"_id": "69f536192e7966f4032f2299",
"name": "Production On-Prem Agent",
"type": "server",
"server": {
"hostURI": "https://agent.example.com:7020",
"systemToken": "********",
"ipRanges": [
"10.0.0.0/8"
]
}
}
]Last updated
Was this helpful?