# Events_ReadActivityActors_Workspace

`GET /v1/accounts/{account}/workspaces/{workspace}/events:activityActors`

Reads recorded person names for a bounded page of actions.

- Base URL: `https://junction-api.qualiastudios.dev`
- Authentication: an API key in the `X-API-Key` header

## Parameters

- `account` (path, string, required): The account id.
- `workspace` (path, string, required): The workspace id.
- `events` (query, array of string): At most 100 canonical event references.

## Responses

- `200` OK: `application/json` `qualia.v1.ReadActivityActorsResponse`
- `default` Default error response: `application/json` `google.rpc.Status`

## Schemas

```yaml
qualia.v1.ReadActivityActorsResponse:
  type: object
  properties:
    actors:
      type: array
      items:
        $ref: "#/components/schemas/qualia.v1.ActivityActorName"
      description: Missing records or names are omitted; absence never proves deletion.
    credentials:
      type: array
      items:
        $ref: "#/components/schemas/qualia.v1.ActivityCredential"
      description: |-
        One entry per requested event that recorded a key the platform let the
        caller see. Omitted when the key is unknown, in another organization,
        outside the caller's access, or the platform is unreachable.
  description: |-
    Only names recorded for people without credential evidence, plus the
    current, platform-authorized metadata of recorded keys.
qualia.v1.ActivityActorName:
  type: object
  properties:
    event:
      type: string
      description: Canonical event reference.
    displayName:
      type: string
      description: |-
        Recorded display name, at most 256 characters, without an email fallback:
        the session's person, or the verified initiator a service recorded.
    initiator:
      type: boolean
      description: |-
        True when `display_name` is a verified initiator's rather than the
        principal's own.
  description: A recorded human name. Key ownership and trusted initiators are separate.
qualia.v1.ActivityCredential:
  type: object
  properties:
    event:
      type: string
      description: Canonical event reference.
    currentLabel:
      type: string
      description: |-
        The key's current name, only for its creator or an admin of its owning
        space. At most 128 characters; empty when not permitted.
    currentOwner:
      enum:
        - CREDENTIAL_OWNER_UNSPECIFIED
        - PERSON
        - SPACE
      type: string
      description: Who owns the key now.
      format: enum
    currentOwnerLabel:
      type: string
      description: |-
        The owning person's current display name for a personal key, or the
        owning space's current name for a service key; empty when not permitted.
    currentCreatorLabel:
      type: string
      description: The creator's current display name, for a service key; empty otherwise.
    revoked:
      type: boolean
      description: Revoked now. Only set alongside `current_label`.
  description: |-
    Current metadata of the key an event recorded, read from the platform as the
    caller. It is today's state, not the state when the event was written, and
    it never names who used the key.
google.rpc.Status:
  oneOf:
    - $ref: "#/components/schemas/ApiError"
    - $ref: "#/components/schemas/GatewayError"
  description: "The body of a failed call: one of the two shapes below."
ApiError:
  title: API error
  type: object
  required:
    - code
    - message
    - retryable
    - details
  properties:
    code:
      type: string
      description: The gRPC code name in upper case, e.g. `NOT_FOUND`.
    message:
      type: string
    retryable:
      type: boolean
      description: Whether the same call may succeed if retried.
    details:
      type: array
      items:
        type: object
      description: "Empty, except when a dataset copy or move is refused: then one `google.rpc.ErrorInfo` with the refusal's `reason` code, its `domain` and, in `metadata`, the datasets it names."
  description: A refusal from the API itself.
GatewayError:
  title: Gateway error
  type: object
  required:
    - detail
  properties:
    detail:
      type: string
      description: What went wrong.
  description: A refusal from the gateway before the call reaches the API, for example `401` bad or missing API key, `403` key lacks the scope or environment closed, `413` body too large.
```