Semaphor

List assignments

Returns all assignments in the project. Each assignment includes the definition it references, the connection, and the resolved actor details (name, email) so you can see who has what policy.

Secret parameter values are masked (shown as "***") when the definition's CLS configuration marks them as secret.

GET
/api/management/v1/projects/{projectId}/unified-security/assignments

Authorization

UnifiedSecurityBearerAuth
AuthorizationBearer <token>

A project-scoped access token generated for an organization Admin. Generate one with the Token API using the Admin's orgUserId. The token project must match the request path, and the user must currently be active and belong to the project organization. Dashboard tokens and tenant-user project tokens are not accepted.

In: header

Path Parameters

projectId*string

Your Semaphor project ID.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X get "https://semaphor.cloud/api/management/v1/projects/string/unified-security/assignments"
{
  "ok": true,
  "data": {
    "assignments": [
      {
        "assignment": {
          "id": "string",
          "definitionId": "string",
          "scopeType": "ALL_TENANTS",
          "orgUserId": "string",
          "tenantId": "string",
          "tenantUserId": "string",
          "params": {
            "property1": "string",
            "property2": "string"
          },
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z"
        },
        "rlsHealth": {
          "status": "NOT_APPLICABLE",
          "errorCount": 0,
          "warningCount": 0,
          "infoCount": 0
        },
        "definition": {
          "id": "string",
          "projectId": "string",
          "name": "string"
        },
        "connection": {
          "id": "string",
          "name": "string",
          "type": "string"
        },
        "orgUser": {
          "id": "string",
          "name": "string",
          "email": "user@example.com"
        },
        "tenant": {
          "id": "string",
          "name": "string"
        },
        "tenantUser": {
          "id": "string",
          "name": "string",
          "email": "user@example.com",
          "tenantId": "string",
          "tenant": {
            "id": "string",
            "name": "string"
          }
        }
      }
    ]
  }
}
{
  "ok": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "string",
    "details": {}
  }
}
{
  "ok": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "string",
    "details": {}
  }
}
{
  "ok": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "string",
    "details": {}
  }
}
{
  "ok": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "string",
    "requestId": "string",
    "issues": [
      {
        "code": "INVALID_JSON",
        "fieldPath": "string",
        "message": "string"
      }
    ],
    "retryable": true
  }
}