Events

Get a single event by ID.

get/spaces/{spaceIdentifier}/events/{id}

Request

  • Base URL
    https://demo.octopus.app/api
  • URL
    https://demo.octopus.app/api/spaces/{spaceIdentifier}/events/{id}
  • Auth
    • API key in header X-Octopus-ApiKey
    • or API key in query parameter ApiKey
    • or API key in header X-NuGet-ApiKey

Path parameters

spaceIdentifierstring required

Identifier (ID or slug) of the space

idstring required

The ID of the event

Response

The requested event

Actorstring

Gets or sets a readable description of the AI tool that created the event, such as Claude. It includes the tool's client ID and redirect URI. To read those values separately, use ActorOAuthClient. Null when the event wasn't created through an OAuth connection.

ActorType'Unknown' | 'System' | 'User' | 'Agent' | 'ServiceAccount'

Gets or sets whether a user, an AI agent, a service account, or Octopus itself created the event. Use this field to find changes made by AI agents. Null for events created before Octopus recorded this.

ApiKeyActorType'User' | 'AiAgent'

Gets or sets the actor type of the API key used to authenticate the request, if applicable.

ApiKeyHintstring

Gets or sets the obfuscated hint of the API key used to authenticate the request, if applicable.

ApiKeyIdstring

Gets or sets the ID of the API key used to authenticate the request, if applicable.

Categorystring

Gets or sets the event category.

Commentsstring

Gets or sets any user-provided comments that were recorded with the event.

Detailsstring

Gets or sets the details of the event. For events representing a modification to a document use the ChangeDetails property.

Idstring

Gets or sets a unique identifier for this resource.

IdentityEstablishedWithstring

Gets or sets a description of how the user performing the event identified themselves to Octopus.

IpAddressstring

The IP address of the user that created the event.

IsServiceboolean

Gets or sets whether the user who created the event is a service user or an interactive user.

LastModifiedBystring

Gets or sets the username of the user who last modified this resource.

LastModifiedOnstring date-time

Gets or sets the date/time that this resource was last modified.

Linksobject

Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.

Messagestring

Gets or sets the message text that summarizes the event.

MessageHtmlstring

Gets or sets the message text that summarizes the event, HTML formatted with links to the related documents.

Occurredstring date-time

Gets or sets the date/time that the event took place.

OnBehalfOfstring

Gets or sets the ID of the user an AI agent acted for. If the agent has its own service account, this is that account's ID. Null when an AI agent didn't create the event.

RelatedDocumentIdsstring[]

Gets or sets a collection of document ID's that this event relates to. Note that the document ID's may no longer exist.

ServiceAccountType'Standard' | 'Agent'

Gets or sets the type of service account that created the event. Null when the user is not a service account.

SpaceIdstring

Gets or sets the SpaceId of the event. This represents the space in which the event was raised.

UserAgentstring

Gets or sets the user agent header value from the request that triggered the event

UserIdstring

Gets or sets the ID of the user who created the event.

Usernamestring

Gets or sets the name of the user who created the event.

Example response

{
  "Actor": "Claude (client_id: https://claude.ai/oauth/mcp-oauth-client-metadata, redirect_uri: https://claude.ai/api/mcp/auth_callback)",
  "ActorOAuthClient": {
    "ClientId": "https://claude.ai/oauth/mcp-oauth-client-metadata",
    "ClientName": "Claude",
    "RedirectUri": "https://claude.ai/api/mcp/auth_callback"
  },
  "ActorType": "Agent",
  "Category": "Modified",
  "ChangeDetails": {
    "Differences": [
      {
        "path": "/IsDisabled",
        "op": "replace",
        "value": true
      }
    ],
    "DocumentContext": {
      "Id": "Tenants-1",
      "Name": "ExampleTenant"
    }
  },
  "IdentityEstablishedWith": "Session cookie",
  "IpAddress": "127.0.0.1",
  "Links": {
    "Self": "/api/..."
  },
  "Message": "Tenant ExampleTenant was modified",
  "MessageHtml": "Tenant ExampleTenant was modified",
  "OnBehalfOf": "Users-1",
  "RelatedDocumentIds": [
    "Tenants-1"
  ],
  "SpaceId": "Spaces-1",
  "UserAgent": "OctopusClient-js/2026.3.15581",
  "UserId": "Users-1",
  "Username": "MyUserName"
}

Changes

No recorded changes to this operation across all 13 revisions of this API.