users.json 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. {
  2. "get": {
  3. "tags": ["Projects"],
  4. "description": "Return a list of users seen within this project.",
  5. "operationId": "List a Project's Users",
  6. "parameters": [
  7. {
  8. "name": "organization_id_or_slug",
  9. "in": "path",
  10. "description": "The id or slug of the organization.",
  11. "required": true,
  12. "schema": {
  13. "type": "string"
  14. }
  15. },
  16. {
  17. "name": "project_id_or_slug",
  18. "in": "path",
  19. "description": "The id or slug of the project.",
  20. "required": true,
  21. "schema": {
  22. "type": "string"
  23. }
  24. },
  25. {
  26. "name": "query",
  27. "in": "query",
  28. "description": "Limit results to users matching the given query. Prefixes should be used to suggest the field to match on: `id`, `email`, `username`, `ip`. For example, `query=email:foo@example.com`",
  29. "schema": {
  30. "type": "string"
  31. }
  32. }
  33. ],
  34. "responses": {
  35. "200": {
  36. "description": "Success",
  37. "content": {
  38. "application/json": {
  39. "schema": {
  40. "type": "array",
  41. "items": {
  42. "type": "object",
  43. "required": ["username", "email"],
  44. "properties": {
  45. "username": {
  46. "type": "string",
  47. "nullable": true
  48. },
  49. "email": {
  50. "type": "string",
  51. "nullable": true
  52. }
  53. }
  54. }
  55. },
  56. "example": [
  57. {
  58. "username": "sentry",
  59. "email": "sentry@example.com"
  60. }
  61. ]
  62. }
  63. }
  64. },
  65. "403": {
  66. "description": "Forbidden"
  67. }
  68. },
  69. "security": [
  70. {
  71. "auth_token": ["project:read"]
  72. }
  73. ]
  74. }
  75. }