Skip to content
Connect an agent

Profiles

Get a profile

Get a profile.

GET/v1/profiles/{id}

TL;DR

QuestionAnswer
What does it do?Get a profile.
What does it need?An API key or an OAuth access token.
What does it take?id in the path.
What does it return?Status 200 with a body of type Profile.
In the SDK?flung.profiles.get()
What can go wrong?401 Missing, unknown, revoked or expired API key; 404 No such profile in this workspace; 422 The request failed validation; 429 Too many requests for this credential; wait for retry-after seconds. Every failure has the same error shape.

Example

curl
curl -X GET 'https://api.flung.dev/v1/profiles/prof_aaaaaaaaaaaaaaaaaaaaaaaa' \  --header "Authorization: Bearer $FLUNG_API_KEY"

A successful answer looks like this:

json
{  "id": "prof_aaaaaaaaaaaaaaaaaaaaaaaa",  "name": "string",  "externalId": "string",  "createdAt": "2026-11-01T09:00:00.000Z",  "updatedAt": "2026-11-01T09:00:00.000Z"}

Path parameters

FieldTypeRequiredDescription
idstringyes

Responses

StatusMeaningBody
200The profile.Profile
401Missing, unknown, revoked or expired API key.Error
404No such profile in this workspace.Error
422The request failed validation.Error
429Too many requests for this credential; wait for retry-after seconds.Error

Response body

A 200 answer has the type Profile.

FieldTypeRequiredDescription
idstringyes
namestringyes
externalIdstring | nullyes
createdAtstringyes
updatedAtstringyes

See also

DocWhy
API referenceEvery endpoint
SchemasEvery request and response type
ErrorsEvery error code and what to do about it