Other endpoints

Embed

<a href="https://hermeticor.com/docs/ref-other-endpoints"><img src="https://hermeticor.com/docs/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/caf5dc05-15f7-4e0c-bdb8-ab29ede6211e/pages/9b8b485e-df2a-4959-8c16-36d30bd083b0/social-card.svg?v=3e7ae33eec8b" alt="Other endpoints" width="600" height="315"></a>

POSThttps://hermeticor.com/ingest/v1/segment

Segment/RudderStack-compatible track, identify, page

Request body

application/json

typestringrequired

track | identify | page | screen

eventstring

namestring

userIdstring

anonymousIdstring

messageIdstring

timestampstring

propertiesobject

traitsobject

contextobject

Show child parameters

traitsobject

userAgentstring

ipstring

pageobject

consentobject

Show child parameters

analyticsboolean

marketingboolean

{
  "type": "track",
  "event": "string",
  "name": "string",
  "userId": "string",
  "anonymousId": "string",
  "messageId": "string",
  "timestamp": "string",
  "properties": {},
  "traits": {},
  "context": {
    "traits": {},
    "userAgent": "string",
    "ip": "string",
    "page": {}
  },
  "consent": {
    "analytics": true,
    "marketing": true
  }
}

Code samples

cURL

curl -X POST "https://hermeticor.com/ingest/v1/segment" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"track","event":"string","name":"string","userId":"string","anonymousId":"string","messageId":"string","timestamp":"string","properties":{},"traits":{},"context":{"traits":{},"userAgent":"string","ip":"string","page":{}},"consent":{"analytics":true,"marketing":true}}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "accepted": 0,
  "duplicates": 0,
  "rejected": [
    {
      "index": 0,
      "reason": "string"
    }
  ],
  "profileId": "string"
}

Schema

acceptedintegerrequired

duplicatesintegerrequired

rejectedRejectedItem[]required

Show child parameters

indexintegerrequired

reasonstringrequired

profileIdstring

4XX Default Response

Example

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}

Schema

errorobjectrequired

Show child parameters

codestringrequired

messagestringrequired

detailsobject

5XX Default Response

Same as 4XX · POST /ingest/v1/segment

GEThttps://hermeticor.com/v1/roles

Parameters

limitintegerquery

Page size; omitted returns the whole list

cursorstringquery

Opaque: the nextCursor of the previous page

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/roles" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "items": [
    {
      "name": "string",
      "baseRole": "admin",
      "grant": [],
      "deny": [],
      "restrictions": {},
      "id": "string",
      "scopes": [
        "string"
      ]
    }
  ],
  "nextCursor": "string"
}

Schema

itemsItemsItem99[]required

Show child parameters

namestringrequired

baseRolestringrequired

admin | marketer | sales | analyst | viewer

grantstring[]required

= []

denystring[]required

= []

restrictionsobjectrequired

= {}

idstringrequired

scopesstring[]required

nextCursorstringrequired

4XX Default Response

Same as 4XX · POST /ingest/v1/segment

5XX Default Response

Same as 4XX · POST /ingest/v1/segment

POSThttps://hermeticor.com/v1/roles

Request body

application/json

namestringrequired

baseRolestringrequired

admin | marketer | sales | analyst | viewer

grantstring[]

= []

denystring[]

= []

restrictionsobject

= {}

{
  "name": "string",
  "baseRole": "admin",
  "grant": [],
  "deny": [],
  "restrictions": {}
}

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/roles" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","baseRole":"admin","grant":[],"deny":[],"restrictions":{}}'

TypeScript

Python

PHP

Ruby

Java

Responses

201 Default Response

Example

{
  "name": "string",
  "baseRole": "admin",
  "grant": [],
  "deny": [],
  "restrictions": {},
  "id": "string",
  "scopes": [
    "string"
  ]
}

Schema

namestringrequired

baseRolestringrequired

admin | marketer | sales | analyst | viewer

grantstring[]required

= []

denystring[]required

= []

restrictionsobjectrequired

= {}

idstringrequired

scopesstring[]required

4XX Default Response

Same as 4XX · POST /ingest/v1/segment

5XX Default Response

Same as 4XX · POST /ingest/v1/segment

PUThttps://hermeticor.com/v1/roles/{id}

Parameters

idstringpathrequired

Request body

application/json

namestringrequired

baseRolestringrequired

admin | marketer | sales | analyst | viewer

grantstring[]

= []

denystring[]

= []

restrictionsobject

= {}

{
  "name": "string",
  "baseRole": "admin",
  "grant": [],
  "deny": [],
  "restrictions": {}
}

Code samples

cURL

curl -X PUT "https://hermeticor.com/v1/roles/{id}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","baseRole":"admin","grant":[],"deny":[],"restrictions":{}}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 201 · POST /v1/roles

4XX Default Response

Same as 4XX · POST /ingest/v1/segment

5XX Default Response

Same as 4XX · POST /ingest/v1/segment

DELETEhttps://hermeticor.com/v1/roles/{id}

Parameters

idstringpathrequired

Code samples

cURL

curl -X DELETE "https://hermeticor.com/v1/roles/{id}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "ok": true
}

Schema

okbooleanrequired

true

4XX Default Response

Same as 4XX · POST /ingest/v1/segment

5XX Default Response

Same as 4XX · POST /ingest/v1/segment

PUThttps://hermeticor.com/v1/members/{userId}/custom-role

Parameters

userIdstringpathrequired

Request body

application/json

roleIdstringrequired

{
  "roleId": "string"
}

Code samples

cURL

curl -X PUT "https://hermeticor.com/v1/members/{userId}/custom-role" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"roleId":"string"}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · DELETE /v1/roles/{id}

4XX Default Response

Same as 4XX · POST /ingest/v1/segment

5XX Default Response

Same as 4XX · POST /ingest/v1/segment

GEThttps://hermeticor.com/v1/compliance/gpc

Whether a browser Global Privacy Control / Do Not Track signal counts as a tracking opt-out (default on)

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/compliance/gpc" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "honour": true
}

Schema

honourbooleanrequired

4XX Default Response

Same as 4XX · POST /ingest/v1/segment

5XX Default Response

Same as 4XX · POST /ingest/v1/segment

PUThttps://hermeticor.com/v1/compliance/gpc

Request body

application/json

honourbooleanrequired

{
  "honour": true
}

Code samples

cURL

curl -X PUT "https://hermeticor.com/v1/compliance/gpc" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"honour":true}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · GET /v1/compliance/gpc

4XX Default Response

Same as 4XX · POST /ingest/v1/segment

5XX Default Response

Same as 4XX · POST /ingest/v1/segment

GEThttps://hermeticor.com/v1/compliance/trash-retention

Days deleted campaigns, lists and archived templates stay restorable (0 = forever)

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/compliance/trash-retention" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "days": 0
}

Schema

daysintegerrequired

4XX Default Response

Same as 4XX · POST /ingest/v1/segment

5XX Default Response

Same as 4XX · POST /ingest/v1/segment

PUThttps://hermeticor.com/v1/compliance/trash-retention

Request body

application/json

daysintegerrequired

{
  "days": 0
}

Code samples

cURL

curl -X PUT "https://hermeticor.com/v1/compliance/trash-retention" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":0}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · GET /v1/compliance/trash-retention

4XX Default Response

Same as 4XX · POST /ingest/v1/segment

5XX Default Response

Same as 4XX · POST /ingest/v1/segment

Next part

Updated Nov 8, 2026

Was this page helpful?