Créer / mettre à jour une mission

Crée une nouvelle mission ou met à jour une mission existante via son identifiant client.

Créer une mission

post

https://api.api-engagement.beta.gouv.frhttps://api.bac-a-sable.api-engagement.beta.gouv.frhttp://localhost:3002

/v2/mission

Crée une nouvelle mission pour votre organisation.

La mission est immédiatement soumise aux règles de modération automatique : si elle est incomplète (description trop courte, pas d'adresse, etc.), le champ "statusCode" sera positionné à "REFUSED" avec un commentaire explicatif.

Rate limiting : endpoint soumis à limitation de débit.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Clé API fournie par l'équipe API Engagement

Body

application/json

clientIdstringRequired

Identifiant unique de la mission dans votre système (immuable)

Example: mission-2024-001

titlestringRequired

Titre de la mission

Example: Animateur bénévole en maison de retraite

descriptionstringOptional

Description complète (minimum 300 caractères recommandé pour la modération)

applicationUrlstring · uriOptional

URL de candidature

domainstringOptional

Domaine d'action

Example: sante

activitiesstring[]OptionalExample: ["animation","accompagnement"]

tagsstring[]Optional

tasksstring[]Optional

audiencestring[]Optional

requirementsstring[]Optional

softSkillsstring[]Optional

romeSkillsstring[]Optional

remotestring · enumOptionalPossible values:

schedulestringOptionalExample: 2 heures par semaine

startAtstring · date-timeOptional

endAtstring · date-timeOptional

prioritystringOptional

placesinteger · min: 1Optional

compensationAmountnumberOptional

compensationUnitstring · enumOptionalPossible values:

compensationTypestring · enumOptionalPossible values:

openToMinorsbooleanOptional

reducedMobilityAccessiblebooleanOptional

closeToTransportbooleanOptional

typestring · enumOptionalPossible values:

organizationClientIdstringOptional

Identifiant de l'organisation dans votre système

organizationNamestringOptional

Requis si un autre champ "organization*" est renseigné

organizationDescriptionstringOptional

organizationUrlstring · uriOptional

organizationTypestringOptional

organizationLogostring · uriOptional

organizationRNAstringOptional

organizationSirenstringOptional

organizationSiretstringOptional

organizationFullAddressstringOptional

organizationPostCodestringOptional

organizationCitystringOptional

organizationDepartmentstringOptional

organizationDepartmentCodestringOptional

organizationDepartmentNamestringOptional

organizationStatusJuridiquestringOptional

organizationBeneficiariesstring[]Optional

organizationActionsstring[]Optional

organizationReseauxstring[]Optional

Responses

201

Mission créée

application/json

400

Paramètres invalides

application/json

401

Clé API manquante ou invalide

application/json

409

Conflit — la ressource existe déjà

application/json

429

Limite de débit atteinte

application/json

post

/v2/mission

HTTPcURLJavaScriptPython

POST /v2/mission HTTP/1.1
Host: api.api-engagement.beta.gouv.fr
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1424

{
  "clientId": "mission-2024-001",
  "title": "Animateur bénévole en maison de retraite",
  "description": "text",
  "applicationUrl": "https://example.com",
  "domain": "sante",
  "activities": [
    "animation",
    "accompagnement"
  ],
  "tags": [
    "text"
  ],
  "tasks": [
    "text"
  ],
  "audience": [
    "text"
  ],
  "requirements": [
    "text"
  ],
  "softSkills": [
    "text"
  ],
  "romeSkills": [
    "text"
  ],
  "remote": "no",
  "schedule": "2 heures par semaine",
  "startAt": "2026-03-28T17:35:37.736Z",
  "endAt": "2026-03-28T17:35:37.736Z",
  "priority": "text",
  "places": 1,
  "compensationAmount": 1,
  "compensationUnit": "hour",
  "compensationType": "gross",
  "openToMinors": true,
  "reducedMobilityAccessible": true,
  "closeToTransport": true,
  "addresses": [
    {
      "street": "12 rue de la Paix",
      "postalCode": "75001",
      "city": "Paris",
      "departmentCode": "75",
      "departmentName": "Paris",
      "region": "Île-de-France",
      "country": "France"
    }
  ],
  "type": "benevolat",
  "organizationClientId": "text",
  "organizationName": "text",
  "organizationDescription": "text",
  "organizationUrl": "https://example.com",
  "organizationType": "text",
  "organizationLogo": "https://example.com",
  "organizationRNA": "text",
  "organizationSiren": "text",
  "organizationSiret": "text",
  "organizationFullAddress": "text",
  "organizationPostCode": "text",
  "organizationCity": "text",
  "organizationDepartment": "text",
  "organizationDepartmentCode": "text",
  "organizationDepartmentName": "text",
  "organizationStatusJuridique": "text",
  "organizationBeneficiaries": [
    "text"
  ],
  "organizationActions": [
    "text"
  ],
  "organizationReseaux": [
    "text"
  ]
}

{
  "ok": true,
  "data": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "clientId": "mission-bénévolat-2024-001",
    "publisherId": "5f5931496c7ea514150a818f",
    "statusCode": "ACCEPTED",
    "title": "Animateur bénévole en maison de retraite",
    "applicationUrl": "https://example.org/missions/001/postuler",
    "domain": "sante",
    "activities": [
      "animation",
      "accompagnement"
    ],
    "audience": [
      "seniors",
      "personnes-isolees"
    ],
    "remote": "no",
    "schedule": "2 heures par semaine le samedi matin",
    "places": 5,
    "openToMinors": true,
    "reducedMobilityAccessible": true,
    "addresses": [
      {
        "street": "12 rue de la Paix",
        "zip": "75001",
        "city": "Paris",
        "department": "75",
        "departmentName": "Paris",
        "region": "Île-de-France",
        "country": "France",
        "location": {
          "lat": 48.8698,
          "lon": 2.3303
        }
      }
    ],
    "organizationName": "Croix-Rouge française",
    "organizationRNA": "W751206979",
    "organizationSiren": "775672272",
    "organizationSiret": "77567227221138",
    "organizationUrl": "https://www.croix-rouge.fr",
    "createdAt": "2024-01-15T09:00:00.000Z",
    "updatedAt": "2024-03-01T14:30:00.000Z",
    "closeToTransport": true
  }
}

Modifier une mission

put

https://api.api-engagement.beta.gouv.frhttps://api.bac-a-sable.api-engagement.beta.gouv.frhttp://localhost:3002

/v2/mission/{clientId}

Mise à jour partielle d'une mission (sémantique PATCH). Seuls les champs fournis dans le corps sont modifiés. Les règles de modération automatique sont réévaluées sur l'état complet résultant.

Rate limiting : endpoint soumis à limitation de débit.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Clé API fournie par l'équipe API Engagement

Path parameters

clientIdstringRequired

Identifiant de la mission dans votre système

Example: mission-2024-001

Body

application/json

Tous les champs sont optionnels — seuls les champs fournis sont mis à jour

titlestringOptional

descriptionstringOptional

applicationUrlstring · uriOptional

domainstringOptional

activitiesstring[]Optional

tagsstring[]Optional

tasksstring[]Optional

audiencestring[]Optional

requirementsstring[]Optional

softSkillsstring[]Optional

romeSkillsstring[]Optional

remotestring · enumOptionalPossible values:

schedulestringOptional

startAtstring · date-timeOptional

endAtstring · date-timeOptional

prioritystringOptional

placesinteger · min: 1Optional

compensationAmountnumberOptional

compensationUnitstring · enumOptionalPossible values:

compensationTypestring · enumOptionalPossible values:

openToMinorsbooleanOptional

reducedMobilityAccessiblebooleanOptional

closeToTransportbooleanOptional

typestring · enumOptionalPossible values:

organizationClientIdstringOptional

organizationNamestringOptional

Requis si un autre champ "organization*" est renseigné

organizationDescriptionstringOptional

organizationUrlstring · uriOptional

organizationTypestringOptional

organizationLogostring · uriOptional

organizationRNAstringOptional

organizationSirenstringOptional

organizationSiretstringOptional

organizationFullAddressstringOptional

organizationPostCodestringOptional

organizationCitystringOptional

organizationStatusJuridiquestringOptional

organizationBeneficiariesstring[]Optional

organizationActionsstring[]Optional

organizationReseauxstring[]Optional

Responses

200

Mission mise à jour

application/json

okbooleanOptionalExample: true

400

Paramètres invalides

application/json

401

Clé API manquante ou invalide

application/json

404

Ressource introuvable

application/json

429

Limite de débit atteinte

application/json

put

/v2/mission/{clientId}

HTTPcURLJavaScriptPython

PUT /v2/mission/{clientId} HTTP/1.1
Host: api.api-engagement.beta.gouv.fr
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1213

{
  "title": "text",
  "description": "text",
  "applicationUrl": "https://example.com",
  "domain": "text",
  "activities": [
    "text"
  ],
  "tags": [
    "text"
  ],
  "tasks": [
    "text"
  ],
  "audience": [
    "text"
  ],
  "requirements": [
    "text"
  ],
  "softSkills": [
    "text"
  ],
  "romeSkills": [
    "text"
  ],
  "remote": "no",
  "schedule": "text",
  "startAt": "2026-03-28T17:35:37.736Z",
  "endAt": "2026-03-28T17:35:37.736Z",
  "priority": "text",
  "places": 1,
  "compensationAmount": 1,
  "compensationUnit": "hour",
  "compensationType": "gross",
  "openToMinors": true,
  "reducedMobilityAccessible": true,
  "closeToTransport": true,
  "addresses": [
    {
      "street": "12 rue de la Paix",
      "postalCode": "75001",
      "city": "Paris",
      "departmentCode": "75",
      "departmentName": "Paris",
      "region": "Île-de-France",
      "country": "France"
    }
  ],
  "type": "benevolat",
  "organizationClientId": "text",
  "organizationName": "text",
  "organizationDescription": "text",
  "organizationUrl": "https://example.com",
  "organizationType": "text",
  "organizationLogo": "https://example.com",
  "organizationRNA": "text",
  "organizationSiren": "text",
  "organizationSiret": "text",
  "organizationFullAddress": "text",
  "organizationPostCode": "text",
  "organizationCity": "text",
  "organizationStatusJuridique": "text",
  "organizationBeneficiaries": [
    "text"
  ],
  "organizationActions": [
    "text"
  ],
  "organizationReseaux": [
    "text"
  ]
}

{
  "ok": true,
  "data": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "clientId": "mission-bénévolat-2024-001",
    "publisherId": "5f5931496c7ea514150a818f",
    "statusCode": "ACCEPTED",
    "title": "Animateur bénévole en maison de retraite",
    "applicationUrl": "https://example.org/missions/001/postuler",
    "domain": "sante",
    "activities": [
      "animation",
      "accompagnement"
    ],
    "audience": [
      "seniors",
      "personnes-isolees"
    ],
    "remote": "no",
    "schedule": "2 heures par semaine le samedi matin",
    "places": 5,
    "openToMinors": true,
    "reducedMobilityAccessible": true,
    "addresses": [
      {
        "street": "12 rue de la Paix",
        "zip": "75001",
        "city": "Paris",
        "department": "75",
        "departmentName": "Paris",
        "region": "Île-de-France",
        "country": "France",
        "location": {
          "lat": 48.8698,
          "lon": 2.3303
        }
      }
    ],
    "organizationName": "Croix-Rouge française",
    "organizationRNA": "W751206979",
    "organizationSiren": "775672272",
    "organizationSiret": "77567227221138",
    "organizationUrl": "https://www.croix-rouge.fr",
    "createdAt": "2024-01-15T09:00:00.000Z",
    "updatedAt": "2024-03-01T14:30:00.000Z",
    "closeToTransport": true
  }
}