Skip to content
forgit api docs

Retrieve an agent token

GET
/api/v4/projects/{id}/cluster_agents/{agent_id}/tokens/{token_id}

Retrieves a specified agent token. You must have the Developer, Maintainer, or Owner role to use this endpoint. Returns a 404 if the agent token has been revoked.

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
id
required
One of:
string

The ID or URL-encoded path of the project

agent_id
required
integer

The ID of an agent

token_id
required
integer

The ID of the agent token

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

OK

Media type application/json
object
id
integer format: int64
name
string
description
string
agent_id
integer format: int64
status
string
created_at
string format: date-time
created_by_user_id
integer format: int64
last_used_at
string format: date-time
Example 
{
  "id": 1,
  "agent_id": 1,
  "created_by_user_id": 1
}

400

Section titled “ 400 ”

Bad Request

404

Section titled “ 404 ”

Not Found