Skip to main content
GET
Get a project actor

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Path Parameters

orgID
string
required
Pattern: ^org_[a-z2-7]{26}$
projectID
string
required
Pattern: ^proj_[a-z2-7]{26}$
actorID
string
required
Pattern: ^actr_[a-z2-7]{26}$

Response

The actor.

id
string
required
Pattern: ^actr_[a-z2-7]{26}$
org_id
string
required
Pattern: ^org_[a-z2-7]{26}$
project_id
string
required
Pattern: ^proj_[a-z2-7]{26}$
provider
enum<string>
required

omnara for Omnara identities, integration for hosted integration senders, or external for API-managed actors.

Available options:
omnara,
integration,
external
provider_user_id
string
required

Stable sender identifier within the actor identity namespace.

metadata
object
required

Saved actor attributes. Hosted integration actors store source_label (such as Slack) for display without a live integration lookup.

created_at
string<date-time>
required
updated_at
string<date-time>
required
provider_tenant_id
string

Project-scoped identity namespace. Integration actors use a stable platform namespace (slack:, discord, or github:github.com), shared across configured bots and integration kinds on that platform. Retained for attribution after integration deletion; not an authorization principal.

display_name
string