Get one grant

Returns one of the caller’s grants with the client that holds it, the teams it can act in right now, that is its stored team scope intersected with the holder’s live memberships, each scope marked as baseline or elevation with the elevation’s expiry, and the always-allow tool policies on its live hosted MCP sessions. Requires a browser session. A grant belonging to anyone else answers 404.

GET/v1/me/grants/{grantId}

Authorization

AuthorizationBearer token · headerrequired

`Authorization: Bearer ` with an API key (`sfa_` prefix), an OAuth access token, a session token, or a Space machine credential (`sfm_` prefix).

Path parameters

grantIdstringrequired

min length 1

Responses

200Response for status 200

$schemastring

Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.

dataobjectrequired

Show propertiesHide properties

idstringrequired

namestringrequired

kindstringrequired

Allowed:agent``app``cli``handoff``api-key``machine

clientNamestring

logoUristring

statusstringrequired

Allowed:active``expired``revoked

teamsobject[]required

Show propertiesHide properties

Array of object

teamIdstringrequired

teamNamestringrequired

allTeamsbooleanrequired

scopesobject[]required

Show propertiesHide properties

Array of object

idstringrequired

labelstringrequired

sourcestringrequired

Allowed:baseline``elevation

elevatedUntilstring

matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

toolPoliciesobject[]required

Show propertiesHide properties

Array of object

sessionIdstringrequired

toolstringrequired

teamIdstringrequired

lastUsedAtstring | anyrequired

Show propertiesHide properties

Any of:

string

string<date-time>

any

any

createdAtstringrequired

expiresAtstringrequired

defaultError. Every 4xx and 5xx response is one RFC 9457 problem document served as `application/problem+json`.

$schemastring

Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.

typestringrequired

URL of the documentation page for this error. Derived from `code`.

titlestringrequired

Human-readable name of the error type. Derived from `code`.

statusintegerrequired

HTTP status of the response, repeated in the body.

min -9007199254740991 · max 9007199254740991

detailstringrequired

What went wrong in this request.

codestringrequired

Stable snake_case error code. Match on this, not on `detail`.

pointerstring

RFC 6901 JSON Pointer to the request field or batch entry that failed, for example `/files/37/path`. Present on validation failures.

detailsobject

Machine-readable context keyed by the error code.

suggestionsstring[]

Recovery steps safe to show to a person.

nextstring[]

Commands or API requests to run next, usable as written.

requestIdstringrequired

ID of this request, from the `X-Request-Id` header or generated. Quote it when contacting support.

Try it

Server

Base URLhttps://api.spacefast.comCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

grantIdpath*

Send

Request

cURL

curl -X GET "https://api.spacefast.com/v1/me/grants/string" \
  -H "Authorization: Bearer YOUR_TOKEN"

JavaScript

const response = await fetch("https://api.spacefast.com/v1/me/grants/string", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Python

import requests

response = requests.get(
    "https://api.spacefast.com/v1/me/grants/string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

200default

{
  "$schema": "http://example.com",
  "data": {
    "id": "string",
    "name": "string",
    "kind": "agent",
    "clientName": "string",
    "logoUri": "string",
    "status": "active",
    "teams": [\
      {\
        "teamId": "string",\
        "teamName": "string"\
      }\
    ],
    "allTeams": true,
    "scopes": [\
      {\
        "id": "string",\
        "label": "string",\
        "source": "baseline",\
        "elevatedUntil": "2019-08-24T14:15:22Z"\
      }\
    ],
    "toolPolicies": [\
      {\
        "sessionId": "string",\
        "tool": "string",\
        "teamId": "string"\
      }\
    ],
    "lastUsedAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z",
    "expiresAt": "2019-08-24T14:15:22Z"
  }
}

{
  "$schema": "http://example.com",
  "type": "string",
  "title": "string",
  "status": -9007199254740991,
  "detail": "string",
  "code": "string",
  "pointer": "string",
  "details": {
    "property1": null,
    "property2": null
  },
  "suggestions": [\
    "string"\
  ],
  "next": [\
    "string"\
  ],
  "requestId": "string"
}