Skip to main content
GET
Find selectable terminals for an Agent

Authorizations

Authorization
string
header
required

Bearer JWT token or API Key (sk-*).

Path Parameters

agentId
string
required

Query Parameters

serviceAccountUserId
string<uuid>

Execution Service Account to preview while editing. Required for a new Agent; existing Agents default to their assigned Service Account.

Literal terminal or workspace name search.

Maximum string length: 100
skip
number
default:0
Required range: x >= 0
take
number
default:50
Required range: 1 <= x <= 50
agentTerminalIds
string<uuid>[]

Hydrate only selected terminal IDs, still constrained by the Service Account live ACL.

Maximum array length: 50

Response

200 - application/json
data
object[]
required
results
number
required
total
number
required
next
boolean
required
Last modified on October 5, 2026