Salfio
APIReference

Get an activity

Fetch a single activity by UUID. The response includes the full concatenated message content, truncated at 10 KiB. Cross-tenant lookups and activities that don't belong to the path's client return `404 not_found`.

GET
/clients/{clientId}/activities/{activityId}

Authorization

bearerAuth
AuthorizationBearer <token>

Salfio API tokens start with the literal prefix sk_live_ followed by 32 base62 characters (≈190 bits of entropy). Tokens are hashed at rest with argon2id and shown to the user only once at creation.

In: header

Path Parameters

clientId*string
Formatuuid
activityId*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.salfio.com/v1/clients/497f6eca-6276-4993-bfeb-53cbbbba6f08/activities/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "meta": {
    "cursor": "string",
    "hasMore": true
  },
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
    "type": "email",
    "source": "manual",
    "subject": "string",
    "content": "string",
    "occurredAt": "2019-08-24T14:15:22Z",
    "participants": [
      "user@example.com"
    ],
    "immutable": true,
    "archivedAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Authentication required"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "client not found"
  }
}
{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded",
    "details": {
      "retry_after_seconds": 30
    }
  }
}

Create a manual activity (Stubbed — SAL-230 follow-up)

**Stubbed in v1.0.** Returns `200 { data: null, meta: {} }` without side effects. Full implementation requires an `archived_at` column on the conversations table plus the source/operation matrix from the v1.0 spec — tracked as a SAL-230 follow-up.

Delete or archive an activity (Stubbed — SAL-230 follow-up)

**Stubbed in v1.0.** The spec defines different semantics per source (`manual` deletes, integrations archive); both require the `archived_at` column which isn't in the model yet.