Skip to main content
PUT
Update an attached component's placement on the stack

Authorizations

Authorization
string
header
required

StatusStack authenticates requests with API keys, created via the dashboard with granular permissions (read, write, delete, admin, *).

API keys support version compatibility:

  • v1 keys: Can only access v1 endpoints
  • v2 keys: Can access both v1 and v2 endpoints

Available permissions:

  • read: View resources (GET requests)
  • write: Create and update resources (POST, PUT requests)
  • delete: Delete resources (DELETE requests)
  • admin: Administrative access to all resources
  • *: Wildcard permission (all actions allowed)

Path Parameters

stack_id
string<uuid>
required
component_id
string<uuid>
required

Body

application/json

Where an attached component sits on the stack. Carried on the stack/component pivot.

sort_order
integer
Required range: x >= 0
is_critical
boolean
custom_label
string
Maximum string length: 255
settings
object

Response

Placement updated

message
string
Example:

"Component settings updated successfully"