Semaphor

Get an assignment

Returns a single assignment with its definition, connection, and resolved actor details.

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

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.

assignmentId*string

The ID of the assignment to operate on.

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/string"
{
  "ok": true,
  "data": {
    "assignment": {
      "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",
    "details": {}
  }
}