Use this endpoint to retrieve your organization's team details and available Swif agent installer builds. This is useful for automating agent deployment across your device fleet or integrating installer information into your internal tooling.

Prerequisites

API Key — You'll need your organization's API token to authenticate requests. Visit Settings > API token > Generate API key in the Swif dashboard, or see Your API key token for Swif.ai for detailed instructions.

Team ID — You can find your Team ID at:

🇺🇸 US region: app.swif.ai/org/account/team
🇪🇺 EU region: app.eu.swif.ai/org/account/team

Endpoint

GET /restful/organization/teams/:teamId

Replace :teamId with your organization's Team ID.

The Global base URL (api.swifteam.com).
The EU base URL (api.eu.swifteam.com).

CURL Request

curl --location 'https://api.swifteam.com/restful/organization/teams/{TEAM_ID}' \
--header 'Authorization: Bearer {TOKEN}'

Replace {TEAM_ID} with your Team ID and {TOKEN} with your API key.

EU customers: Use https://api.eu.swifteam.com as the base URL instead.

Sample JSON Response

{
  "teamId": "66d0b8ac2e00001d0080a762",
  "teamName": "Acme Corp",
  "agentBuilds": [
    {
      "status": "ACTIVE",
      "id": "6832a1bc4f0000120045e3a1",
      "downloadUrl": "https://cdn.swifteam.com/agent/swif-agent-1.5.2-macos-arm64.pkg",
      "version": "1.5.2",
      "osName": "macOS"
    },
    {
      "status": "ACTIVE",
      "id": "6832a1bc4f0000120045e3a2",
      "downloadUrl": "https://cdn.swifteam.com/agent/swif-agent-1.5.2-macos-x64.pkg",
      "version": "1.5.2",
      "osName": "macOS"
    },
    {
      "status": "ACTIVE",
      "id": "6832a1bc4f0000120045e3a3",
      "downloadUrl": "https://cdn.swifteam.com/agent/swif-agent-1.5.2-windows-x64.msi",
      "version": "1.5.2",
      "osName": "Windows"
    },
    {
      "status": "ACTIVE",
      "id": "6832a1bc4f0000120045e3a4",
      "downloadUrl": "https://cdn.swifteam.com/agent/swif-agent-1.5.2-linux-x64.deb",
      "version": "1.5.2",
      "osName": "Linux"
    }
  ]
}

Response Fields

Field	Type	Description
`teamId`	String	Your organization's unique Team ID.
`teamName`	String	The display name of your team.
`agentBuilds`	Array	A list of available Swif agent installer builds for your team.
`agentBuilds[].status`	String	The current status of the build (e.g., `ACTIVE`).
`agentBuilds[].id`	String	The unique identifier for the build.
`agentBuilds[].downloadUrl`	String	A direct download URL for the agent installer.
`agentBuilds[].version`	String	The version number of the agent build.
`agentBuilds[].osName`	String	The target operating system (e.g., `macOS`, `Windows`, `Linux`).