Update filter pins

PUT /links/filter-pins is part of the Links group. Its parameters and response shape below are generated from the live OpenAPI document.

Base URL: https://api.power301.com/v1
Auth: Bearer token
Idempotent: Yes
Returns: application/json

The request

Send a JSON body to PUT /links/filter-pins. pins is the only required field.

# Update filter pins
curl -X PUT "https://api.power301.com/v1/links/filter-pins" \
  -H "Authorization: Bearer $POWER301_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pins": [
      {
        "kind": "host",
        "value": "string"
      }
    ]
  }'

Body parameters

Field	Description
pinsRequiredarray<object>

The response

A 200 returns the record as JSON.

{
  "pins": [
    {
      "kind": "string",
      "value": "string"
    }
  ]
}

Status codes

200

SuccessReplaces the workspace's pinned filters with pins (at most 10; duplicates are dropped) and returns them.

401

UnauthenticatedUnauthenticated

422

Validation failedA field was rejected. errors lists every field with its reason.

429

Too many requestsToo many requests

484

Bad requestThe workspace role of the authenticated user is too low for this action.