Skip to content
Docs
Esc
↑↓navigate↵open⌘Jpreview

List team skills

Returns every preset team skill, such as SEO or Spam protection, with its instructions and whether it is on for this team. setup names a secret team variable the skill needs, and configured says whether the team saved it. The variable’s value is never returned.

GET/v1/teams/{teamId}/skills
Authorization
AuthorizationBearer token · headerrequired

Better Auth session, OAuth access token, OAuth client-credentials token, or sfm_ Space machine credential.

or
AuthorizationOAuth2 access token · headerrequired

OAuth 2.0 with explicit Spacefast capability scopes. Use the authorization-code flow for people and client credentials for machines.

Scopes:spaces:read
Path parameters
teamIdstringrequired
min length 1
Responses
200

Response for status 200

$schemastring<uri>

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

dataobject[]required

Every team skill, in catalog order.

Show properties
Array of object
keystringrequired

Team skill key.

Allowed:seono-slopfront-end-craftsocial-previewsspeedaccessibilityspam-protectioncontact-formssecurity-headersprivacy-consent
titlestringrequired
summarystringrequired

One sentence on what the skill does.

inspiredBystring | nullrequired

The WordPress plugins it echoes, or null for a Spacefast original.

sectionsobject[]required

What agents are told, section by section.

Show properties
Array of object
headingstringrequired
Allowed:When this appliesDoDon'tVerify
itemsstring[]required
setupobject | nullrequired
Show properties
Any of:
object
variablestringrequired

Secret team variable the skill needs, by name.

configuredbooleanrequired

True when the team has saved that variable.

null
null
enabledbooleanrequired
updatedAtstring<date-time> | nullrequired

When someone last turned it on or off, or null while it has its default.

Show properties
Any of:
string<date-time>
string<date-time>
null
null
updatedByobject | nullrequired
Show properties
Any of:
object
typestringrequired

person: a signed-in member. agent: an OAuth agent connection.

Allowed:personagentapi_keysystem
userIdstring | nullrequired

The person, or the person who connected the agent.

connectionIdstring | nullrequired

The agent connection (grant) that wrote it, for agent writes.

namestring | nullrequired

Display name: the person, agent, or API key.

null
null
default

Problem details (RFC 9457). Any 4xx/5xx response is one application/problem+json document.

$schemastring<uri>

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

typestringrequired

Problem type URI resolving to the error docs page. The server derives it mechanically from code against the docs origin.

titlestringrequired

Short human-readable summary of the problem type. The server derives it mechanically from code.

statusintegerrequired

HTTP status code of this response, repeated in the body.

min -9007199254740991 · max 9007199254740991
detailstringrequired

Human-readable failure explanation for this occurrence.

codestringrequired

Stable snake_case error code naming the failed public contract.

pointerstring

RFC 6901 JSON Pointer into the failing request field, for example "/files/37/path", on validation failures.

detailsobject

Machine-readable context for the error code.

fixstring

One sentence on what to do about this error code, the same text as the type page. Read it before retrying.

suggestionsstring[]

Actionable recovery steps safe to show in dashboards, SDKs, and CLI output.

nextstring[]

Copy-pasteable commands or API requests an agent can run next.

requestIdstringrequired

The request id to quote when contacting support.

Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.spacefast.com/v1/teams/string/skills' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "$schema": "http://example.com",
  "data": [
    {
      "key": "seo",
      "title": "string",
      "summary": "string",
      "inspiredBy": "string",
      "sections": [
        {
          "heading": "When this applies",
          "items": [
            "string"
          ]
        }
      ],
      "setup": {
        "variable": "string",
        "configured": true
      },
      "enabled": true,
      "updatedAt": "2019-08-24T14:15:22Z",
      "updatedBy": {
        "type": "person",
        "userId": "string",
        "connectionId": "string",
        "name": "string"
      }
    }
  ]
}

Was this page helpful?