Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

GET en DELETE: Reacties beheren

Les 7 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Meer dan alleen aanmaken
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Best Practices
  5. Belangrijkste punten

Meer dan alleen aanmaken

De Responses API beperkt zich niet tot het aanmaken van reacties. Twee aanvullende endpoints stellen u in staat om opgeslagen reacties op te halen en te verwijderen. Deze bewerkingen zijn essentieel voor het bouwen van robuuste applicaties met geschiedenisbeheer.

GET /v1/responses/{id}

Een reactie ophalen

curl https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

De API retourneert exact hetzelfde JSON-object als tijdens het aanmaken:

{
  "id": "resp-abc123def456",
  "object": "response",
  "created_at": 1712000000,
  "status": "completed",
  "model": "grok-4.20-0309-reasoning",
  "output": [...],
  "usage": {...}
}

Praktische gebruiksscenario’s

Hervatten van een conversatie: Uw applicatie slaat de laatste response_id op in de gebruikerssessie. Bij opnieuw verbinden haalt u de reactie op om de vorige context weer te geven.

# Gebruiker keert terug na een onderbreking
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Toon de laatste uitwisseling
print(f"Last response: {previous.output[0].content[0].text[:200]}...")

# Ga verder met de conversatie
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Where were we?",
    previous_response_id=last_response_id
)

Kostencontrole: Loop door uw opgeslagen reacties om het verbruik per gebruiker of functie te analyseren.

response = client.responses.retrieve("resp-abc123")
cost_usd = response.usage.cost_in_nano_usd / 1e9
input_tokens = response.usage.input_tokens
output_tokens = response.usage.output_tokens
print(f"Cost: ${cost_usd:.6f} | In: {input_tokens} | Out: {output_tokens}")

Foutafhandeling

Als de reactie niet bestaat (verwijderd of verlopen), retourneert de API een 404-fout:

{
  "error": {
    "message": "Response not found",
    "type": "not_found_error"
  }
}

Behandel dit geval in uw code:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Response not found: {e}")
    # Start een nieuwe conversatie

DELETE /v1/responses/{id}

Een reactie verwijderen

curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

Bij succes retourneert de verwijdering een statuscode 200. De bewerking is onomkeerbaar.

Impact op gekoppelde conversaties

Wanneer u een reactie verwijdert waarnaar anderen verwijzen via previous_response_id, verdwijnt de context van die reactie uit de keten. Daaropvolgende reacties worden niet verwijderd, maar verliezen wel de toegang tot de eerdere context.

resp-1 → resp-2 → resp-3 → resp-4
         ↑ deleted

Als u resp-2 verwijdert, blijven resp-3 en resp-4 bestaan, maar is de context van resp-1 en resp-2 niet langer toegankelijk voor nieuwe gekoppelde verzoeken.

Geautomatiseerde opschoning

Voor productieapplicaties implementeert u periodieke opschoning:

import datetime

def cleanup_old_responses(response_ids, max_age_days=7):
    for rid in response_ids:
        try:
            resp = client.responses.retrieve(rid)
            age = datetime.datetime.now().timestamp() - resp.created_at
            if age > max_age_days * 86400:
                client.responses.delete(rid)
                print(f"Deleted: {rid}")
        except Exception:
            pass  # Reeds verwijderd of verlopen

Best Practices

  • Sla ID’s op: bewaar response_ids in uw database samen met conversatiemetagegevens
  • Ruim regelmatig op: wacht niet op de automatische vervaldatum van 30 dagen voor gevoelige gegevens
  • Behandel 404-fouten: een reactie kan tussen verzoeken door verdwijnen (verloop, handmatige verwijdering)
  • Documenteer uw ketens: traceer voor foutopsporing de previous_response_id-koppelingen tussen uw reacties

Belangrijkste punten

  • GET /v1/responses/{id} haalt een reactie op met alle inhoud en metagegevens
  • DELETE /v1/responses/{id} verwijdert een reactie permanent – een onomkeerbare bewerking
  • Het verwijderen van een tussenliggende reactie verbreekt de context van de conversatieketen
  • Behandel 404-fouten: reacties verlopen automatisch na 30 dagen
  • Bewaar response_ids in uw eigen database voor traceerbaarheid