---
updatedAt: 2026-05-21T18:12:22.000Z
---

# Liste des objectifs des webhooks


Récupérer les objectifs disponibles pour un webhook.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0.0",
    "description": "IBM Verify API",
    "title": "IBM Verify API"
  },
  "servers": [
    {
      "url": "https://{tenanturl}",
      "variables": {
        "tenanturl": {
          "default": "{tenant_url}",
          "description": "URL of your IBM Security Verify tenant"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Webhook-Configuration"
    }
  ],
  "paths": {
    "/config/v1.0/webhooks/purposes": {
      "get": {
        "tags": [
          "Webhook-Configuration"
        ],
        "summary": "Liste des objectifs des webhooks",
        "description": "\nRécupérer les objectifs disponibles pour un webhook.",
        "operationId": "webhookPurposes",
        "responses": {
          "200": {
            "description": "La configuration du webhook",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Purposes"
                }
              }
            }
          },
          "400": {
            "description": "La requête ne peut pas être traitée car le corps de la requête contient du JSON mal structuré.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebError"
                }
              }
            }
          },
          "401": {
            "description": "L'utilisateur non authentifié ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebError"
                }
              }
            }
          },
          "403": {
            "description": "L'utilisateur non authentifié ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebError"
                }
              }
            }
          },
          "404": {
            "description": "la ressource est introuvable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebError"
                }
              }
            }
          },
          "500": {
            "description": "Erreur de serveur interne.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebError"
                }
              }
            }
          }
        },
        "x-publicAPI": "true",
        "x-category": "IBM Verify API"
      }
    }
  },
  "components": {
    "schemas": {
      "Purpose": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "Purposes": {
        "type": "object",
        "properties": {
          "purposes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Purpose"
            }
          }
        }
      },
      "WebError": {
        "type": "object",
        "properties": {
          "messageDescription": {
            "type": "string",
            "description": "Un message descriptif spécifique au local du demandeur."
          },
          "messageId": {
            "type": "string",
            "description": "L'identifiant de la clé du message."
          }
        },
        "description": "WebError est une description de l'erreur standard/de l'erreur"
      }
    }
  },
  "x-original-swagger-version": "2.0",
  "x-explorer-enabled": false
}
```