Get a suspension case

GET

/api/v1/admin/suspension-cases/{id}

curl --request GET \
  --url https://api.deploybase.eu/api/v1/api/v1/admin/suspension-cases/example \
  --header 'Authorization: <Authorization>'

The case with every team row (origin and cascaded, with state, hold reason and last error) and every subject (frozen person; the email hash is never returned).

Authorizations

• BearerAuth

Parameters

Path Parameters

id

required

string

Suspension case ID (UUID)

Responses

200

OK

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

object

cascades

boolean

class

string

Allowed values: phishing malware spam_network illegal_content copyright payment other

closed_at

string

closed_by

string

escalated_at

string

escalated_by

string

escalated_from

Escalation evidence: set when an open single-team case was escalated in place to a cascade class. Class/Cascades are the new values; EscalatedFrom is the class it had, Reason stays the original statement and EscalationReason is the escalating admin’s.

string

Allowed values: phishing malware spam_network illegal_content copyright payment other

escalation_reason

string

id

string

opened_at

string

opened_by

string

opened_by_email

OpenedByEmail is resolved at read time for the admin view; never stored.

string

origin_team_id

string

origin_team_name

string

reason

string

subjects

Array<object>

object

case_id

string

confirmed_transferee

ConfirmedTransferee: the person became owner of the origin by a recent transfer (T1) and the admin confirmed them responsible anyway; their teams were classified like any subject’s.

boolean

confirmed_transferee_by

string

email

Email is resolved at read time from the person’s memberships for the admin view; the case stores only the hash.

string

frozen_at

string

id

string

released_at

string

released_by

string

zitadel_user_id

string

teams

Array<object>

object

case_id

string

decided_at

string

hold_reason

string

id

string

last_error

string

owner_count

integer

plan_at_decision

string

resolved_at

string

resolved_by

string

role

string

state

string

suspended_by_case

boolean

team_id

string

team_name

string

via_user_id

string

Example

{
  "data": {
    "class": "phishing",
    "escalated_from": "phishing"
  }
}

400

Bad Request

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

401

Unauthorized

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

403

Forbidden

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

404

Not Found

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

500

Internal Server Error

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

503

Service Unavailable

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}