#Create User Profile

POST /v1/user_profiles

Create User Profile

#Headers

• "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

• string

• "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more

• "message-batches-2024-09-24"

• "prompt-caching-2024-07-31"

• "computer-use-2024-10-22"

• "computer-use-2025-01-24"

• "pdfs-2024-09-25"

• "token-counting-2024-11-01"

• "token-efficient-tools-2025-02-19"

• "output-128k-2025-02-19"

• "files-api-2025-04-14"

• "mcp-client-2025-04-04"

• "mcp-client-2025-11-20"

• "dev-full-thinking-2025-05-14"

• "interleaved-thinking-2025-05-14"

• "code-execution-2025-05-22"

• "extended-cache-ttl-2025-04-11"

• "context-1m-2025-08-07"

• "context-management-2025-06-27"

• "model-context-window-exceeded-2025-08-26"

• "tracks-2025-10-02"

• "fast-mode-2026-02-01"

• "output-300k-2026-03-24"

• "user-profiles-2026-03-24"

• "user-profiles-2026-08-18"

• "user-profiles-2026-09-04"

• "advisor-tool-2026-03-01"

• "managed-agents-2026-04-01"

• "cache-diagnosis-2026-04-07"

• "dreaming-2026-04-21"

• "thinking-token-count-2026-05-13"

• "server-side-fallback-2026-06-01"

• "server-side-fallback-2026-07-01"

• "fallback-credit-2026-06-01"

• "fallback-credit-2026-07-01"

• "agent-memory-2026-07-22"

• "mid-conversation-tool-changes-2026-07-01"

• "compact-2026-01-12"

• "computer-use-2025-11-24"

• "mcp-tunnels-2026-06-22"

• "structured-outputs-2025-11-13"

• "task-budgets-2026-03-13"

• "thinking-display-updates-2026-08-18"

• "ce-user-management-2026-07-13"

• "mid-conversation-output-config-2026-07-01"

• "thinking-binding-controls-2026-08-01"

• "mid-conversation-system-clear-at-2026-08-21"

• "compact-2026-09-04"

• "inline-tools-2026-09-15"

• "mcp-client-2026-09-15"

• "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

#Body parameters

• access_type: optional "application" or "passthrough"

How the platform uses the API for this entity. application (default): the profile represents an individual end-user of the platform's product. passthrough: the profile identifies a company the platform resells Haijun access to.

• "application"

The user profile represents an individual end-user of a product that the platform builds on the API. New profiles get this value by default.

• "passthrough"

The user profile represents a company that the platform resells Haijun access to.

• external_id: optional string or null

Platform's own identifier for this user. Not enforced unique. Maximum 255 characters. Accepted under the user-profiles-2026-03-24 and user-profiles-2026-08-18 beta headers; under user-profiles-2026-09-04 send external_user_details.reference_id instead.

minLength: 1, maxLength: 255

• external_user_details: optional BetaUserProfileExternalUserDetailsParams

Details about the entity this profile represents, as the platform states them. Every field is optional. Accepted under the user-profiles-2026-09-04 beta header only.

• account_status: optional "active" or "suspended" or "blocked" or null

The status of the entity's account on the platform: active, suspended or blocked.

• "active"

The platform has neither restricted nor barred the account of the entity that the user profile represents.

• "suspended"

The platform has restricted the account of the entity that the user profile represents and may restore it.

• "blocked"

The platform has barred the account of the entity that the user profile represents.

• country: optional string or null

The country of the entity (not of the platform), as the platform determines it: an ISO 3166-1 alpha-2 code in upper case, for example US. Only the form, two uppercase ASCII letters, is checked.

• email_hash: optional string or null

A hash of the entity's email address, computed by the platform. Juglow treats it as an opaque string and does not prescribe the hash function. 1 to 255 characters.

minLength: 1, maxLength: 255

• entity_type: optional "individual" or "business" or "non_profit" or "government" or null

What kind of entity the profile represents: individual, business, non_profit or government.

• "individual"

• "business"

• "non_profit"

• "government"

• name_hash: optional string or null

A hash of the entity's name, computed by the platform. Juglow treats it as an opaque string and does not prescribe the hash function. 1 to 255 characters.

minLength: 1, maxLength: 255

• onboarded_at: optional string

When the entity opened its account with the platform, in RFC 3339 format: for an application profile, when the end-user signed up; for a passthrough profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future.

format: date-time

• reference_id: optional string or null

The platform's own reference for the entity, for example the key of the end-user's row in the platform's database. Not interpreted by Juglow and not enforced unique. 1 to 255 characters.

minLength: 1, maxLength: 255

• external_user_onboarded_at: optional string

When the entity this profile represents opened its account with the platform, in RFC 3339 format: for an application profile, when the end-user signed up; for a passthrough profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future. Optional. Accepted under the user-profiles-2026-08-18 beta header; under user-profiles-2026-09-04 send external_user_details.onboarded_at instead.

format: date-time

• metadata: optional map[string]

Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings.

• name: optional string or null

Optional for all profiles. Real-world name of the entity this profile represents (company or individual); for a company the platform resells Haijun access to (access_type passthrough), that company's name where known. Maximum 255 characters.

minLength: 1, maxLength: 255

#Returns

• BetaUserProfile object

A record of an entity that the platform serves through the API, such as an end-user of the platform's product or a company that the platform resells Haijun access to.

A Messages, Message Batches or token counting request can send a profile's id in the juglow-user-profile-id header to attribute the request to that entity.

• type: "user_profile"

Object type. Always user_profile.

• id: string

Unique identifier for this user profile, prefixed uprof_.

• created_at: string

When this user profile was created, in RFC 3339 format.

format: date-time

• metadata: map[string]

Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.

• trust_grants: map[BetaUserProfileTrustGrant]

Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.

• status: "active" or "pending" or "rejected"

Status of the trust grant.

• "active"

• "pending"

• "rejected"

• updated_at: string

When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.

format: date-time

• access_type: optional "application" or "passthrough"

How the platform uses the API for this entity: application (default) or passthrough. Present under the user-profiles-2026-08-18 and later beta headers.

• "application"

The user profile represents an individual end-user of a product that the platform builds on the API. New profiles get this value by default.

• "passthrough"

The user profile represents a company that the platform resells Haijun access to.

• external_id: optional string or null

Platform's own identifier for this user. Not enforced unique. Present under the user-profiles-2026-03-24 and user-profiles-2026-08-18 beta headers; under user-profiles-2026-09-04 the value is external_user_details.reference_id.

• external_user_details: optional BetaUserProfileExternalUserDetails

Details about the entity this profile represents, as the platform states them; not verified by Juglow. Present under the user-profiles-2026-09-04 beta header, with every field present and null until the platform supplies a value; the earlier beta headers serve reference_id as the top-level external_id, and user-profiles-2026-08-18 serves onboarded_at as external_user_onboarded_at.

• account_status: "active" or "suspended" or "blocked" or null

The status of the entity's account on the platform: active, suspended or blocked. null until the platform supplies one.

• "active"

The platform has neither restricted nor barred the account of the entity that the user profile represents.

• "suspended"

The platform has restricted the account of the entity that the user profile represents and may restore it.

• "blocked"

The platform has barred the account of the entity that the user profile represents.

• country: string or null

The country the platform associates with the entity, as an ISO 3166-1 alpha-2 code. null until the platform supplies one.

• email_hash: string or null

The platform-computed hash of the entity's email address. null until the platform supplies one.

• entity_type: "individual" or "business" or "non_profit" or "government" or null

What kind of entity the profile represents: individual, business, non_profit or government. null until the platform supplies one.

• "individual"

• "business"

• "non_profit"

• "government"

• name_hash: string or null

The platform-computed hash of the entity's name. null until the platform supplies one.

• onboarded_at: string or null

When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one.

format: date-time

• reference_id: string or null

The platform's own reference for the entity. null until the platform supplies one.

• external_user_onboarded_at: optional string or null

When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one. Present under the user-profiles-2026-08-18 beta header; under user-profiles-2026-09-04 the value is external_user_details.onboarded_at.

format: date-time

• name: optional string or null

Real-world name of the entity this profile represents (company or individual). For a company the platform resells Haijun access to (access_type passthrough) this is that company's name.

#Example

curl https://haijun.my.id/v1/user_profiles \
    -H 'Content-Type: application/json' \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: user-profiles-2026-08-18' \
    -H "X-Api-Key: $JUGLOW_API_KEY" \
    -d '{
          "external_id": "user_12345",
          "external_user_onboarded_at": "2024-11-02T08:15:00Z",
          "metadata": {}
        }'

#Response (200)

{
  "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
  "created_at": "2026-03-15T10:00:00Z",
  "metadata": {},
  "trust_grants": {
    "cyber": {
      "status": "active"
    }
  },
  "type": "user_profile",
  "updated_at": "2026-03-15T10:00:00Z",
  "access_type": "application",
  "external_id": "user_12345",
  "external_user_details": {
    "account_status": "active",
    "country": "country",
    "email_hash": "email_hash",
    "entity_type": "individual",
    "name_hash": "name_hash",
    "onboarded_at": "2019-12-27T18:11:19.117Z",
    "reference_id": "reference_id"
  },
  "external_user_onboarded_at": "2024-11-02T08:15:00Z",
  "name": "Example User"
}

#List User Profiles

GET /v1/user_profiles

List User Profiles

#Query parameters

• limit: optional number

The maximum number of user profiles to return, from 1 to 100. Defaults to 20.

format: int32

• order: optional "asc" or "desc"

The sort direction, applied to the field that order_by selects. Defaults to desc.

• "asc"

Oldest first when order_by is created_at, or names in ascending order when order_by is name.

• "desc"

Newest first when order_by is created_at, or names in descending order when order_by is name. This is the default.

• order_by: optional "created_at" or "name"

The field to sort user profiles by, in the direction that order sets. Defaults to created_at.

• "created_at"

Sort by when each user profile was created. This is the default.

• "name"

Sort by name, ignoring the case of ASCII letters. Profiles without a name come last in either direction.

• page: optional string

The cursor for the page to return, taken from next_page in a previous response.

Leave it out to get the first page.

#Headers

• "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

• string

• "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more

• "message-batches-2024-09-24"

• "prompt-caching-2024-07-31"

• "computer-use-2024-10-22"

• "computer-use-2025-01-24"

• "pdfs-2024-09-25"

• "token-counting-2024-11-01"

• "token-efficient-tools-2025-02-19"

• "output-128k-2025-02-19"

• "files-api-2025-04-14"

• "mcp-client-2025-04-04"

• "mcp-client-2025-11-20"

• "dev-full-thinking-2025-05-14"

• "interleaved-thinking-2025-05-14"

• "code-execution-2025-05-22"

• "extended-cache-ttl-2025-04-11"

• "context-1m-2025-08-07"

• "context-management-2025-06-27"

• "model-context-window-exceeded-2025-08-26"

• "tracks-2025-10-02"

• "fast-mode-2026-02-01"

• "output-300k-2026-03-24"

• "user-profiles-2026-03-24"

• "user-profiles-2026-08-18"

• "user-profiles-2026-09-04"

• "advisor-tool-2026-03-01"

• "managed-agents-2026-04-01"

• "cache-diagnosis-2026-04-07"

• "dreaming-2026-04-21"

• "thinking-token-count-2026-05-13"

• "server-side-fallback-2026-06-01"

• "server-side-fallback-2026-07-01"

• "fallback-credit-2026-06-01"

• "fallback-credit-2026-07-01"

• "agent-memory-2026-07-22"

• "mid-conversation-tool-changes-2026-07-01"

• "compact-2026-01-12"

• "computer-use-2025-11-24"

• "mcp-tunnels-2026-06-22"

• "structured-outputs-2025-11-13"

• "task-budgets-2026-03-13"

• "thinking-display-updates-2026-08-18"

• "ce-user-management-2026-07-13"

• "mid-conversation-output-config-2026-07-01"

• "thinking-binding-controls-2026-08-01"

• "mid-conversation-system-clear-at-2026-08-21"

• "compact-2026-09-04"

• "inline-tools-2026-09-15"

• "mcp-client-2026-09-15"

• "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

#Returns

• data: array of BetaUserProfile

User profiles on this page.

• type: "user_profile"

Object type. Always user_profile.

• id: string

Unique identifier for this user profile, prefixed uprof_.

• created_at: string

When this user profile was created, in RFC 3339 format.

format: date-time

• metadata: map[string]

Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.

• trust_grants: map[BetaUserProfileTrustGrant]

Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.

• status: "active" or "pending" or "rejected"

Status of the trust grant.

• "active"

• "pending"

• "rejected"

• updated_at: string

When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.

format: date-time

• access_type: optional "application" or "passthrough"

How the platform uses the API for this entity: application (default) or passthrough. Present under the user-profiles-2026-08-18 and later beta headers.

• "application"

The user profile represents an individual end-user of a product that the platform builds on the API. New profiles get this value by default.

• "passthrough"

The user profile represents a company that the platform resells Haijun access to.

• external_id: optional string or null

Platform's own identifier for this user. Not enforced unique. Present under the user-profiles-2026-03-24 and user-profiles-2026-08-18 beta headers; under user-profiles-2026-09-04 the value is external_user_details.reference_id.

• external_user_details: optional BetaUserProfileExternalUserDetails

Details about the entity this profile represents, as the platform states them; not verified by Juglow. Present under the user-profiles-2026-09-04 beta header, with every field present and null until the platform supplies a value; the earlier beta headers serve reference_id as the top-level external_id, and user-profiles-2026-08-18 serves onboarded_at as external_user_onboarded_at.

• account_status: "active" or "suspended" or "blocked" or null

The status of the entity's account on the platform: active, suspended or blocked. null until the platform supplies one.

• "active"

The platform has neither restricted nor barred the account of the entity that the user profile represents.

• "suspended"

The platform has restricted the account of the entity that the user profile represents and may restore it.

• "blocked"

The platform has barred the account of the entity that the user profile represents.

• country: string or null

The country the platform associates with the entity, as an ISO 3166-1 alpha-2 code. null until the platform supplies one.

• email_hash: string or null

The platform-computed hash of the entity's email address. null until the platform supplies one.

• entity_type: "individual" or "business" or "non_profit" or "government" or null

What kind of entity the profile represents: individual, business, non_profit or government. null until the platform supplies one.

• "individual"

• "business"

• "non_profit"

• "government"

• name_hash: string or null

The platform-computed hash of the entity's name. null until the platform supplies one.

• onboarded_at: string or null

When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one.

format: date-time

• reference_id: string or null

The platform's own reference for the entity. null until the platform supplies one.

• external_user_onboarded_at: optional string or null

When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one. Present under the user-profiles-2026-08-18 beta header; under user-profiles-2026-09-04 the value is external_user_details.onboarded_at.

format: date-time

• name: optional string or null

Real-world name of the entity this profile represents (company or individual). For a company the platform resells Haijun access to (access_type passthrough) this is that company's name.

• next_page: string or null

Cursor for the next page, or null when there are no more results.

#Example

curl https://haijun.my.id/v1/user_profiles \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: user-profiles-2026-08-18' \
    -H "X-Api-Key: $JUGLOW_API_KEY"

#Response (200)

{
  "data": [
    {
      "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
      "created_at": "2026-03-15T10:00:00Z",
      "metadata": {},
      "trust_grants": {
        "cyber": {
          "status": "active"
        }
      },
      "type": "user_profile",
      "updated_at": "2026-03-15T10:00:00Z",
      "access_type": "application",
      "external_id": "user_12345",
      "external_user_details": {
        "account_status": "active",
        "country": "country",
        "email_hash": "email_hash",
        "entity_type": "individual",
        "name_hash": "name_hash",
        "onboarded_at": "2019-12-27T18:11:19.117Z",
        "reference_id": "reference_id"
      },
      "external_user_onboarded_at": "2024-11-02T08:15:00Z",
      "name": "Example User"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

#Get User Profile

GET /v1/user_profiles/{user_profile_id}

Get User Profile

#Path parameters

• user_profile_id: string

The ID of the user profile to get (uprof_...).

#Headers

• "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

• string

• "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more

• "message-batches-2024-09-24"

• "prompt-caching-2024-07-31"

• "computer-use-2024-10-22"

• "computer-use-2025-01-24"

• "pdfs-2024-09-25"

• "token-counting-2024-11-01"

• "token-efficient-tools-2025-02-19"

• "output-128k-2025-02-19"

• "files-api-2025-04-14"

• "mcp-client-2025-04-04"

• "mcp-client-2025-11-20"

• "dev-full-thinking-2025-05-14"

• "interleaved-thinking-2025-05-14"

• "code-execution-2025-05-22"

• "extended-cache-ttl-2025-04-11"

• "context-1m-2025-08-07"

• "context-management-2025-06-27"

• "model-context-window-exceeded-2025-08-26"

• "tracks-2025-10-02"

• "fast-mode-2026-02-01"

• "output-300k-2026-03-24"

• "user-profiles-2026-03-24"

• "user-profiles-2026-08-18"

• "user-profiles-2026-09-04"

• "advisor-tool-2026-03-01"

• "managed-agents-2026-04-01"

• "cache-diagnosis-2026-04-07"

• "dreaming-2026-04-21"

• "thinking-token-count-2026-05-13"

• "server-side-fallback-2026-06-01"

• "server-side-fallback-2026-07-01"

• "fallback-credit-2026-06-01"

• "fallback-credit-2026-07-01"

• "agent-memory-2026-07-22"

• "mid-conversation-tool-changes-2026-07-01"

• "compact-2026-01-12"

• "computer-use-2025-11-24"

• "mcp-tunnels-2026-06-22"

• "structured-outputs-2025-11-13"

• "task-budgets-2026-03-13"

• "thinking-display-updates-2026-08-18"

• "ce-user-management-2026-07-13"

• "mid-conversation-output-config-2026-07-01"

• "thinking-binding-controls-2026-08-01"

• "mid-conversation-system-clear-at-2026-08-21"

• "compact-2026-09-04"

• "inline-tools-2026-09-15"

• "mcp-client-2026-09-15"

• "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

#Returns

• BetaUserProfile object

A record of an entity that the platform serves through the API, such as an end-user of the platform's product or a company that the platform resells Haijun access to.

A Messages, Message Batches or token counting request can send a profile's id in the juglow-user-profile-id header to attribute the request to that entity.

• type: "user_profile"

Object type. Always user_profile.

• id: string

Unique identifier for this user profile, prefixed uprof_.

• created_at: string

When this user profile was created, in RFC 3339 format.

format: date-time

• metadata: map[string]

Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.

• trust_grants: map[BetaUserProfileTrustGrant]

Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.

• status: "active" or "pending" or "rejected"

Status of the trust grant.

• "active"

• "pending"

• "rejected"

• updated_at: string

When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.

format: date-time

• access_type: optional "application" or "passthrough"

How the platform uses the API for this entity: application (default) or passthrough. Present under the user-profiles-2026-08-18 and later beta headers.

• "application"

The user profile represents an individual end-user of a product that the platform builds on the API. New profiles get this value by default.

• "passthrough"

The user profile represents a company that the platform resells Haijun access to.

• external_id: optional string or null

Platform's own identifier for this user. Not enforced unique. Present under the user-profiles-2026-03-24 and user-profiles-2026-08-18 beta headers; under user-profiles-2026-09-04 the value is external_user_details.reference_id.

• external_user_details: optional BetaUserProfileExternalUserDetails

Details about the entity this profile represents, as the platform states them; not verified by Juglow. Present under the user-profiles-2026-09-04 beta header, with every field present and null until the platform supplies a value; the earlier beta headers serve reference_id as the top-level external_id, and user-profiles-2026-08-18 serves onboarded_at as external_user_onboarded_at.

• account_status: "active" or "suspended" or "blocked" or null

The status of the entity's account on the platform: active, suspended or blocked. null until the platform supplies one.

• "active"

The platform has neither restricted nor barred the account of the entity that the user profile represents.

• "suspended"

The platform has restricted the account of the entity that the user profile represents and may restore it.

• "blocked"

The platform has barred the account of the entity that the user profile represents.

• country: string or null

The country the platform associates with the entity, as an ISO 3166-1 alpha-2 code. null until the platform supplies one.

• email_hash: string or null

The platform-computed hash of the entity's email address. null until the platform supplies one.

• entity_type: "individual" or "business" or "non_profit" or "government" or null

What kind of entity the profile represents: individual, business, non_profit or government. null until the platform supplies one.

• "individual"

• "business"

• "non_profit"

• "government"

• name_hash: string or null

The platform-computed hash of the entity's name. null until the platform supplies one.

• onboarded_at: string or null

When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one.

format: date-time

• reference_id: string or null

The platform's own reference for the entity. null until the platform supplies one.

• external_user_onboarded_at: optional string or null

When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one. Present under the user-profiles-2026-08-18 beta header; under user-profiles-2026-09-04 the value is external_user_details.onboarded_at.

format: date-time

• name: optional string or null

Real-world name of the entity this profile represents (company or individual). For a company the platform resells Haijun access to (access_type passthrough) this is that company's name.

#Example

curl https://haijun.my.id/v1/user_profiles/$USER_PROFILE_ID \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: user-profiles-2026-08-18' \
    -H "X-Api-Key: $JUGLOW_API_KEY"

#Response (200)

{
  "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
  "created_at": "2026-03-15T10:00:00Z",
  "metadata": {},
  "trust_grants": {
    "cyber": {
      "status": "active"
    }
  },
  "type": "user_profile",
  "updated_at": "2026-03-15T10:00:00Z",
  "access_type": "application",
  "external_id": "user_12345",
  "external_user_details": {
    "account_status": "active",
    "country": "country",
    "email_hash": "email_hash",
    "entity_type": "individual",
    "name_hash": "name_hash",
    "onboarded_at": "2019-12-27T18:11:19.117Z",
    "reference_id": "reference_id"
  },
  "external_user_onboarded_at": "2024-11-02T08:15:00Z",
  "name": "Example User"
}

#Update User Profile

POST /v1/user_profiles/{user_profile_id}

Update User Profile

#Path parameters

• user_profile_id: string

The ID of the user profile to update (uprof_...).

#Headers

• "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

• string

• "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more

• "message-batches-2024-09-24"

• "prompt-caching-2024-07-31"

• "computer-use-2024-10-22"

• "computer-use-2025-01-24"

• "pdfs-2024-09-25"

• "token-counting-2024-11-01"

• "token-efficient-tools-2025-02-19"

• "output-128k-2025-02-19"

• "files-api-2025-04-14"

• "mcp-client-2025-04-04"

• "mcp-client-2025-11-20"

• "dev-full-thinking-2025-05-14"

• "interleaved-thinking-2025-05-14"

• "code-execution-2025-05-22"

• "extended-cache-ttl-2025-04-11"

• "context-1m-2025-08-07"

• "context-management-2025-06-27"

• "model-context-window-exceeded-2025-08-26"

• "tracks-2025-10-02"

• "fast-mode-2026-02-01"

• "output-300k-2026-03-24"

• "user-profiles-2026-03-24"

• "user-profiles-2026-08-18"

• "user-profiles-2026-09-04"

• "advisor-tool-2026-03-01"

• "managed-agents-2026-04-01"

• "cache-diagnosis-2026-04-07"

• "dreaming-2026-04-21"

• "thinking-token-count-2026-05-13"

• "server-side-fallback-2026-06-01"

• "server-side-fallback-2026-07-01"

• "fallback-credit-2026-06-01"

• "fallback-credit-2026-07-01"

• "agent-memory-2026-07-22"

• "mid-conversation-tool-changes-2026-07-01"

• "compact-2026-01-12"

• "computer-use-2025-11-24"

• "mcp-tunnels-2026-06-22"

• "structured-outputs-2025-11-13"

• "task-budgets-2026-03-13"

• "thinking-display-updates-2026-08-18"

• "ce-user-management-2026-07-13"

• "mid-conversation-output-config-2026-07-01"

• "thinking-binding-controls-2026-08-01"

• "mid-conversation-system-clear-at-2026-08-21"

• "compact-2026-09-04"

• "inline-tools-2026-09-15"

• "mcp-client-2026-09-15"

• "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

#Body parameters

• access_type: optional "application" or "passthrough" or null

If present, replaces the stored access type. Omit to leave unchanged.

• "application"

The user profile represents an individual end-user of a product that the platform builds on the API. New profiles get this value by default.

• "passthrough"

The user profile represents a company that the platform resells Haijun access to.

• external_id: optional string or null

If present, replaces the stored external_id. Omit to leave unchanged. Maximum 255 characters. Accepted under the user-profiles-2026-03-24 and user-profiles-2026-08-18 beta headers; under user-profiles-2026-09-04 send external_user_details.reference_id instead.

minLength: 1, maxLength: 255

• external_user_details: optional BetaUserProfileExternalUserDetailsParams

Details about the entity this profile represents, as the platform states them. Each field sent replaces the stored value; omit a field to leave it unchanged. Once set, a value cannot be cleared and null is rejected. Accepted under the user-profiles-2026-09-04 beta header only.

• account_status: optional "active" or "suspended" or "blocked" or null

The status of the entity's account on the platform: active, suspended or blocked.

• "active"

The platform has neither restricted nor barred the account of the entity that the user profile represents.

• "suspended"

The platform has restricted the account of the entity that the user profile represents and may restore it.

• "blocked"

The platform has barred the account of the entity that the user profile represents.

• country: optional string or null

The country of the entity (not of the platform), as the platform determines it: an ISO 3166-1 alpha-2 code in upper case, for example US. Only the form, two uppercase ASCII letters, is checked.

• email_hash: optional string or null

A hash of the entity's email address, computed by the platform. Juglow treats it as an opaque string and does not prescribe the hash function. 1 to 255 characters.

minLength: 1, maxLength: 255

• entity_type: optional "individual" or "business" or "non_profit" or "government" or null

What kind of entity the profile represents: individual, business, non_profit or government.

• "individual"

• "business"

• "non_profit"

• "government"

• name_hash: optional string or null

A hash of the entity's name, computed by the platform. Juglow treats it as an opaque string and does not prescribe the hash function. 1 to 255 characters.

minLength: 1, maxLength: 255

• onboarded_at: optional string

When the entity opened its account with the platform, in RFC 3339 format: for an application profile, when the end-user signed up; for a passthrough profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future.

format: date-time

• reference_id: optional string or null

The platform's own reference for the entity, for example the key of the end-user's row in the platform's database. Not interpreted by Juglow and not enforced unique. 1 to 255 characters.

minLength: 1, maxLength: 255

• external_user_onboarded_at: optional string

If present, replaces the stored account creation time. Omit to leave unchanged; once set, the value cannot be cleared and null is rejected. Must be a complete RFC 3339 timestamp no more than 1 minute in the future. Accepted under the user-profiles-2026-08-18 beta header; under user-profiles-2026-09-04 send external_user_details.onboarded_at instead.

format: date-time

• metadata: optional map[string]

Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters.

• name: optional string or null

If present, replaces the stored name. Omit to leave unchanged. Maximum 255 characters.

minLength: 1, maxLength: 255

#Returns

• BetaUserProfile object

A record of an entity that the platform serves through the API, such as an end-user of the platform's product or a company that the platform resells Haijun access to.

A Messages, Message Batches or token counting request can send a profile's id in the juglow-user-profile-id header to attribute the request to that entity.

• type: "user_profile"

Object type. Always user_profile.

• id: string

Unique identifier for this user profile, prefixed uprof_.

• created_at: string

When this user profile was created, in RFC 3339 format.

format: date-time

• metadata: map[string]

Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.

• trust_grants: map[BetaUserProfileTrustGrant]

Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.

• status: "active" or "pending" or "rejected"

Status of the trust grant.

• "active"

• "pending"

• "rejected"

• updated_at: string

When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.

format: date-time

• access_type: optional "application" or "passthrough"

How the platform uses the API for this entity: application (default) or passthrough. Present under the user-profiles-2026-08-18 and later beta headers.

• "application"

The user profile represents an individual end-user of a product that the platform builds on the API. New profiles get this value by default.

• "passthrough"

The user profile represents a company that the platform resells Haijun access to.

• external_id: optional string or null

Platform's own identifier for this user. Not enforced unique. Present under the user-profiles-2026-03-24 and user-profiles-2026-08-18 beta headers; under user-profiles-2026-09-04 the value is external_user_details.reference_id.

• external_user_details: optional BetaUserProfileExternalUserDetails

Details about the entity this profile represents, as the platform states them; not verified by Juglow. Present under the user-profiles-2026-09-04 beta header, with every field present and null until the platform supplies a value; the earlier beta headers serve reference_id as the top-level external_id, and user-profiles-2026-08-18 serves onboarded_at as external_user_onboarded_at.

• account_status: "active" or "suspended" or "blocked" or null

The status of the entity's account on the platform: active, suspended or blocked. null until the platform supplies one.

• "active"

The platform has neither restricted nor barred the account of the entity that the user profile represents.

• "suspended"

The platform has restricted the account of the entity that the user profile represents and may restore it.

• "blocked"

The platform has barred the account of the entity that the user profile represents.

• country: string or null

The country the platform associates with the entity, as an ISO 3166-1 alpha-2 code. null until the platform supplies one.

• email_hash: string or null

The platform-computed hash of the entity's email address. null until the platform supplies one.

• entity_type: "individual" or "business" or "non_profit" or "government" or null

What kind of entity the profile represents: individual, business, non_profit or government. null until the platform supplies one.

• "individual"

• "business"

• "non_profit"

• "government"

• name_hash: string or null

The platform-computed hash of the entity's name. null until the platform supplies one.

• onboarded_at: string or null

When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one.

format: date-time

• reference_id: string or null

The platform's own reference for the entity. null until the platform supplies one.

• external_user_onboarded_at: optional string or null

When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one. Present under the user-profiles-2026-08-18 beta header; under user-profiles-2026-09-04 the value is external_user_details.onboarded_at.

format: date-time

• name: optional string or null

Real-world name of the entity this profile represents (company or individual). For a company the platform resells Haijun access to (access_type passthrough) this is that company's name.

#Example

curl https://haijun.my.id/v1/user_profiles/$USER_PROFILE_ID \
    -H 'Content-Type: application/json' \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: user-profiles-2026-08-18' \
    -H "X-Api-Key: $JUGLOW_API_KEY" \
    -d '{
          "external_id": "user_12345"
        }'

#Response (200)

{
  "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
  "created_at": "2026-03-15T10:00:00Z",
  "metadata": {},
  "trust_grants": {
    "cyber": {
      "status": "active"
    }
  },
  "type": "user_profile",
  "updated_at": "2026-03-15T10:00:00Z",
  "access_type": "application",
  "external_id": "user_12345",
  "external_user_details": {
    "account_status": "active",
    "country": "country",
    "email_hash": "email_hash",
    "entity_type": "individual",
    "name_hash": "name_hash",
    "onboarded_at": "2019-12-27T18:11:19.117Z",
    "reference_id": "reference_id"
  },
  "external_user_onboarded_at": "2024-11-02T08:15:00Z",
  "name": "Example User"
}

#Create Enrollment URL

POST /v1/user_profiles/{user_profile_id}/enrollment_url

Create Enrollment URL

#Path parameters

• user_profile_id: string

The ID of the user profile to create an enrollment URL for (uprof_...).

#Headers

• "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

• string

• "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more

• "message-batches-2024-09-24"

• "prompt-caching-2024-07-31"

• "computer-use-2024-10-22"

• "computer-use-2025-01-24"

• "pdfs-2024-09-25"

• "token-counting-2024-11-01"

• "token-efficient-tools-2025-02-19"

• "output-128k-2025-02-19"

• "files-api-2025-04-14"

• "mcp-client-2025-04-04"

• "mcp-client-2025-11-20"

• "dev-full-thinking-2025-05-14"

• "interleaved-thinking-2025-05-14"

• "code-execution-2025-05-22"

• "extended-cache-ttl-2025-04-11"

• "context-1m-2025-08-07"

• "context-management-2025-06-27"

• "model-context-window-exceeded-2025-08-26"

• "tracks-2025-10-02"

• "fast-mode-2026-02-01"

• "output-300k-2026-03-24"

• "user-profiles-2026-03-24"

• "user-profiles-2026-08-18"

• "user-profiles-2026-09-04"

• "advisor-tool-2026-03-01"

• "managed-agents-2026-04-01"

• "cache-diagnosis-2026-04-07"

• "dreaming-2026-04-21"

• "thinking-token-count-2026-05-13"

• "server-side-fallback-2026-06-01"

• "server-side-fallback-2026-07-01"

• "fallback-credit-2026-06-01"

• "fallback-credit-2026-07-01"

• "agent-memory-2026-07-22"

• "mid-conversation-tool-changes-2026-07-01"

• "compact-2026-01-12"

• "computer-use-2025-11-24"

• "mcp-tunnels-2026-06-22"

• "structured-outputs-2025-11-13"

• "task-budgets-2026-03-13"

• "thinking-display-updates-2026-08-18"

• "ce-user-management-2026-07-13"

• "mid-conversation-output-config-2026-07-01"

• "thinking-binding-controls-2026-08-01"

• "mid-conversation-system-clear-at-2026-08-21"

• "compact-2026-09-04"

• "inline-tools-2026-09-15"

• "mcp-client-2026-09-15"

• "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

#Returns

• BetaUserProfileEnrollmentURL object

A URL to give to the entity that a user profile represents, so that the entity can enroll for a trust grant.

• type: "enrollment_url"

Object type. Always enrollment_url.

• expires_at: string

When this enrollment URL expires, in RFC 3339 format.

format: date-time

• url: string

Enrollment URL to send to the end user. Valid until expires_at.

#Example

curl https://haijun.my.id/v1/user_profiles/$USER_PROFILE_ID/enrollment_url \
    -X POST \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: user-profiles-2026-08-18' \
    -H "X-Api-Key: $JUGLOW_API_KEY"

#Response (200)

{
  "expires_at": "2026-03-15T10:15:00Z",
  "type": "enrollment_url",
  "url": "https://platform.juglow.my.id/user-profiles/enrollment/M3J0bGJxZ2ppMnptbnB1"
}

#Domain types

#Beta User Profile

• BetaUserProfile object

A record of an entity that the platform serves through the API, such as an end-user of the platform's product or a company that the platform resells Haijun access to.

A Messages, Message Batches or token counting request can send a profile's id in the juglow-user-profile-id header to attribute the request to that entity.

• type: "user_profile"

Object type. Always user_profile.

• id: string

Unique identifier for this user profile, prefixed uprof_.

• created_at: string

When this user profile was created, in RFC 3339 format.

format: date-time

• metadata: map[string]

Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.

• trust_grants: map[BetaUserProfileTrustGrant]

Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.

• status: "active" or "pending" or "rejected"

Status of the trust grant.

• "active"

• "pending"

• "rejected"

• updated_at: string

When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.

format: date-time

• access_type: optional "application" or "passthrough"

How the platform uses the API for this entity: application (default) or passthrough. Present under the user-profiles-2026-08-18 and later beta headers.

• "application"

The user profile represents an individual end-user of a product that the platform builds on the API. New profiles get this value by default.

• "passthrough"

The user profile represents a company that the platform resells Haijun access to.

• external_id: optional string or null

Platform's own identifier for this user. Not enforced unique. Present under the user-profiles-2026-03-24 and user-profiles-2026-08-18 beta headers; under user-profiles-2026-09-04 the value is external_user_details.reference_id.

• external_user_details: optional BetaUserProfileExternalUserDetails

Details about the entity this profile represents, as the platform states them; not verified by Juglow. Present under the user-profiles-2026-09-04 beta header, with every field present and null until the platform supplies a value; the earlier beta headers serve reference_id as the top-level external_id, and user-profiles-2026-08-18 serves onboarded_at as external_user_onboarded_at.

• account_status: "active" or "suspended" or "blocked" or null

The status of the entity's account on the platform: active, suspended or blocked. null until the platform supplies one.

• "active"

The platform has neither restricted nor barred the account of the entity that the user profile represents.

• "suspended"

The platform has restricted the account of the entity that the user profile represents and may restore it.

• "blocked"

The platform has barred the account of the entity that the user profile represents.

• country: string or null

The country the platform associates with the entity, as an ISO 3166-1 alpha-2 code. null until the platform supplies one.

• email_hash: string or null

The platform-computed hash of the entity's email address. null until the platform supplies one.

• entity_type: "individual" or "business" or "non_profit" or "government" or null

What kind of entity the profile represents: individual, business, non_profit or government. null until the platform supplies one.

• "individual"

• "business"

• "non_profit"

• "government"

• name_hash: string or null

The platform-computed hash of the entity's name. null until the platform supplies one.

• onboarded_at: string or null

When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one.

format: date-time

• reference_id: string or null

The platform's own reference for the entity. null until the platform supplies one.

• external_user_onboarded_at: optional string or null

When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one. Present under the user-profiles-2026-08-18 beta header; under user-profiles-2026-09-04 the value is external_user_details.onboarded_at.

format: date-time

• name: optional string or null

Real-world name of the entity this profile represents (company or individual). For a company the platform resells Haijun access to (access_type passthrough) this is that company's name.

#Beta User Profile Enrollment URL

• BetaUserProfileEnrollmentURL object

A URL to give to the entity that a user profile represents, so that the entity can enroll for a trust grant.

• type: "enrollment_url"

Object type. Always enrollment_url.

• expires_at: string

When this enrollment URL expires, in RFC 3339 format.

format: date-time

• url: string

Enrollment URL to send to the end user. Valid until expires_at.

#Beta User Profile External User Details

• BetaUserProfileExternalUserDetails object

Details about the entity this profile represents, as the platform states them. Juglow does not verify them. Every field is present, null until the platform supplies a value.

• account_status: "active" or "suspended" or "blocked" or null

The status of the entity's account on the platform: active, suspended or blocked. null until the platform supplies one.

• "active"

The platform has neither restricted nor barred the account of the entity that the user profile represents.

• "suspended"

The platform has restricted the account of the entity that the user profile represents and may restore it.

• "blocked"

The platform has barred the account of the entity that the user profile represents.

• country: string or null

The country the platform associates with the entity, as an ISO 3166-1 alpha-2 code. null until the platform supplies one.

• email_hash: string or null

The platform-computed hash of the entity's email address. null until the platform supplies one.

• entity_type: "individual" or "business" or "non_profit" or "government" or null

What kind of entity the profile represents: individual, business, non_profit or government. null until the platform supplies one.

• "individual"

• "business"

• "non_profit"

• "government"

• name_hash: string or null

The platform-computed hash of the entity's name. null until the platform supplies one.

• onboarded_at: string or null

When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). null until the platform supplies one.

format: date-time

• reference_id: string or null

The platform's own reference for the entity. null until the platform supplies one.

#Beta User Profile External User Details Params

• BetaUserProfileExternalUserDetailsParams object

• account_status: optional "active" or "suspended" or "blocked" or null

The status of the entity's account on the platform: active, suspended or blocked.

• "active"

The platform has neither restricted nor barred the account of the entity that the user profile represents.

• "suspended"

The platform has restricted the account of the entity that the user profile represents and may restore it.

• "blocked"

The platform has barred the account of the entity that the user profile represents.

• country: optional string or null

The country of the entity (not of the platform), as the platform determines it: an ISO 3166-1 alpha-2 code in upper case, for example US. Only the form, two uppercase ASCII letters, is checked.

• email_hash: optional string or null

A hash of the entity's email address, computed by the platform. Juglow treats it as an opaque string and does not prescribe the hash function. 1 to 255 characters.

minLength: 1, maxLength: 255

• entity_type: optional "individual" or "business" or "non_profit" or "government" or null

What kind of entity the profile represents: individual, business, non_profit or government.

• "individual"

• "business"

• "non_profit"

• "government"

• name_hash: optional string or null

A hash of the entity's name, computed by the platform. Juglow treats it as an opaque string and does not prescribe the hash function. 1 to 255 characters.

minLength: 1, maxLength: 255

• onboarded_at: optional string

When the entity opened its account with the platform, in RFC 3339 format: for an application profile, when the end-user signed up; for a passthrough profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future.

format: date-time

• reference_id: optional string or null

The platform's own reference for the entity, for example the key of the end-user's row in the platform's database. Not interpreted by Juglow and not enforced unique. 1 to 255 characters.

minLength: 1, maxLength: 255

#Beta User Profile Trust Grant

• BetaUserProfileTrustGrant object

The status of one trust grant on a user profile, listed in the profile's trust_grants map under the grant's name.

• status: "active" or "pending" or "rejected"

Status of the trust grant.

• "active"

• "pending"

• "rejected"