[{"data":1,"prerenderedAt":113},["ShallowReactive",2],{"doc:\u002Freference\u002Fmanagement\u002Fproxy-keys":3},{"page":4,"toc":108,"updated":112},{"path":5,"title":6,"seoTitle":7,"description":8,"blocks":9,"examples":94},"\u002Freference\u002Fmanagement\u002Fproxy-keys","Proxy keys","Management API: Proxy Keys","List, issue and revoke the proxy keys your first-party proxies authenticate with. Admin management keys only.",[10,13,22,27,32,73,76,78,85,87,90,92],{"type":11,"text":12},"p","Proxy keys let a proxy on your own domain forward identify requests with the visitor's real details. See [proxy integrations](\u002Fdocs\u002Fproxy-integrations). Only **admin** management keys can manage them; a developer key answers `403`.",{"type":14,"title":15,"fields":16},"fields","Path parameter",[17],{"name":18,"type":19,"text":20,"required":21},"organization_id","string","Your organization, from [Describe the key](\u002Freference\u002Fmanagement\u002Foverview#describe-the-key). A path naming any other organization answers `404`.",true,{"type":23,"level":24,"text":25,"id":26},"heading",2,"List proxy keys","list-proxy-keys",{"type":28,"method":29,"path":30,"auth":31},"endpoint","GET","\u002Fapi\u002Fv1\u002Fmanagement\u002Forganizations\u002F{organization_id}\u002Fproxy-credentials","management",{"type":14,"title":33,"fields":34},"Response",[35],{"name":36,"type":37,"text":38,"children":39},"credentials","ProxyKey[]","Every proxy key, oldest first, revoked keys included.",[40,43,46,49,52,55,58,61,64,67,70],{"name":41,"type":19,"text":42},"id","The key's ID.",{"name":44,"type":19,"text":45},"name","The key's name.",{"name":47,"type":19,"text":48},"environment","`production`, `staging` or `development`.",{"name":50,"type":19,"text":51},"region","The key's data region.",{"name":53,"type":19,"text":54},"prefix","The start of the secret, such as `fly_px_us_production`.",{"name":56,"type":19,"text":57},"last4","The last four characters of the secret.",{"name":59,"type":19,"text":60},"status","`active` or `revoked`.",{"name":62,"type":19,"text":63},"last_used_at","When the key last authenticated a request.",{"name":65,"type":19,"text":66},"expires_at","When the key stops working.",{"name":68,"type":19,"text":69},"created_at","When the key was issued.",{"name":71,"type":19,"text":72},"revoked_at","When the key was revoked.",{"type":23,"level":24,"text":74,"id":75},"Issue a proxy key","issue-a-proxy-key",{"type":28,"method":77,"path":30,"auth":31},"POST",{"type":14,"title":79,"fields":80},"Body",[81,83],{"name":44,"type":19,"text":82,"required":21},"What the key is called.",{"name":47,"type":19,"text":84,"required":21},"The environment of the public keys it will forward: `production`, `staging` or `development`.",{"type":11,"text":86},"Answers `201` with `credential`, a proxy key as above, and `secret`, the whole key, shown once.",{"type":23,"level":24,"text":88,"id":89},"Revoke a proxy key","revoke-a-proxy-key",{"type":28,"method":77,"path":91,"auth":31},"\u002Fapi\u002Fv1\u002Fmanagement\u002Forganizations\u002F{organization_id}\u002Fproxy-credentials\u002F{proxy_credential_id}\u002Frevoke",{"type":11,"text":93},"Refuses the key from the next request on, and answers with the revoked key.",{"request":95,"response":100},[96],{"label":97,"lang":98,"code":99},"cURL","bash","curl -X POST \"https:\u002F\u002Fus.api.fingerly.io\u002Fapi\u002Fv1\u002Fmanagement\u002Forganizations\u002F01a0a7f2-3c18-7b40-8d2e-5f6a9b1c0d37\u002Fproxy-credentials\" \\\n  -H \"x-api-key: $FINGERLY_MANAGEMENT_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"name\": \"Cloudflare Worker\",\n    \"environment\": \"production\"\n  }'",[101,105],{"label":102,"lang":103,"code":104},"201","json","{\n  \"credential\": {\n    \"id\": \"01a0a861-4d2e-7a90-b1c3-5e6f7a8b9c0d\",\n    \"name\": \"Cloudflare Worker\",\n    \"environment\": \"production\",\n    \"region\": \"us\",\n    \"prefix\": \"fly_px_us_production\",\n    \"last4\": \"M2dT\",\n    \"status\": \"active\",\n    \"created_at\": \"2026-09-16T09:20:03Z\"\n  },\n  \"secret\": \"fly_px_us_production_…\"\n}",{"label":106,"lang":103,"code":107},"403","{\n  \"error\": {\n    \"code\": \"insufficient_role\",\n    \"message\": \"only an owner or an admin may manage proxy integrations\",\n    \"status\": 403\n  },\n  \"request_id\": \"01a0a84c-0f11-7a3e-9c2d-4b5e6f708192\"\n}",[109,110,111],{"id":26,"text":25,"level":24},{"id":75,"text":74,"level":24},{"id":89,"text":88,"level":24},"2026-09-17T16:56:08.000Z",1789667797867]