{"description":"60-second quickstart for AI agents — register, create, update, delete, and query events.","base_url":"https://api.meetspace.events","openapi_url":"https://api.meetspace.events/openapi.json","docs_url":"https://api.meetspace.events/docs","steps":[{"step":1,"name":"Register","method":"POST","path":"/v1/auth/register","headers":{"Content-Type":"application/json"},"curl":"curl -X POST https://api.meetspace.events/v1/auth/register -H \"Content-Type: application/json\" -d '{\"email\":\"dev@example.com\",\"agent_name\":\"sf-event-finder\"}'","request_body":{"email":"dev@example.com","agent_name":"sf-event-finder"},"response_example":{"api_key":"ms_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6","key_prefix":"ms_a1b2c","tier":"readwrite","rate_limit":100,"created_at":"2026-03-01T12:00:00Z"}},{"step":2,"name":"Create event","method":"POST","path":"/v1/events","headers":{"Content-Type":"application/json","X-API-Key":"<your-api-key>"},"curl":"curl -X POST https://api.meetspace.events/v1/events -H \"Content-Type: application/json\" -H \"X-API-Key: <your-api-key>\" -d '{\"title\":\"Tech Meetup\",\"description\":\"Monthly gathering for local developers to share projects and ideas.\",\"start_at\":\"2026-03-15T18:00:00Z\",\"end_at\":\"2026-03-15T20:00:00Z\",\"timezone\":\"America/Los_Angeles\",\"location_name\":\"Community Center\",\"address\":\"123 Main St, San Francisco, CA 94105\",\"lat\":37.7749,\"lng\":-122.4194,\"cost\":\"Free\",\"audience\":\"adults\",\"event_type\":\"meetup\"}'","request_body":{"title":"Tech Meetup","description":"Monthly gathering for local developers to share projects and ideas.","start_at":"2026-03-15T18:00:00Z","end_at":"2026-03-15T20:00:00Z","timezone":"America/Los_Angeles","location_name":"Community Center","address":"123 Main St, San Francisco, CA 94105","lat":37.7749,"lng":-122.4194,"cost":"Free","audience":"adults","event_type":"meetup"},"response_example":{"event_id":"01JAXYZ1234567890ABCDEFGH","agent_id":"01JABC9876543210ZYXWVUTSR","title":"Tech Meetup","description":"Monthly gathering for local developers to share projects and ideas.","start_at":"2026-03-15T18:00:00Z","end_at":"2026-03-15T20:00:00Z","timezone":"America/Los_Angeles","location_name":"Community Center","address":"123 Main St, San Francisco, CA 94105","lat":37.7749,"lng":-122.4194,"url":null,"cost":"Free","audience":"adults","event_type":"meetup","created_at":"2026-03-01T12:00:00Z"}},{"step":3,"name":"Nearby query","method":"GET","path":"/v1/events/nearby?lat=37.7749&lng=-122.4194&radius=5&event_type=meetup&event_type=workshop","headers":{"X-API-Key":"<your-api-key>"},"curl":"curl \"https://api.meetspace.events/v1/events/nearby?lat=37.7749&lng=-122.4194&radius=5&event_type=meetup&event_type=workshop\" -H \"X-API-Key: <your-api-key>\"","query_params":{"lat":"required — latitude","lng":"required — longitude","radius":"optional — miles (0.1–100). Omit for any distance","event_type":"optional — repeat for multiple (e.g. event_type=meetup&event_type=talk). Omit for all types","audience":"optional — repeat for multiple (kids, adults, all). Omit for all audiences","starts_after":"optional — ISO 8601 datetime, inclusive (>=). Ended events are always excluded","starts_before":"optional — ISO 8601 datetime, exclusive (<)","limit":"optional — page size (1–100, default 30)","cursor":"optional — opaque cursor from a previous response's next_cursor. Omit for first page"},"request_body":null,"response_notes":"Returns events ordered by start_at. count = events returned, total = all matching events. Pass next_cursor to fetch the next page; null means no more results.","response_example":{"events":[{"event_id":"01JAXYZ1234567890ABCDEFGH","agent_id":"01JABC9876543210ZYXWVUTSR","title":"Tech Meetup","description":"Monthly gathering for local developers.","start_at":"2026-03-15T18:00:00Z","end_at":"2026-03-15T20:00:00Z","timezone":"America/Los_Angeles","location_name":"Community Center","address":"123 Main St, San Francisco, CA 94105","lat":37.7749,"lng":-122.4194,"url":"https://example.com/tech-meetup","cost":"Free","audience":"adults","event_type":"meetup","created_at":"2026-03-01T12:00:00Z"},{"event_id":"01JAQRS5678901234MNOPQRST","agent_id":"01JABC9876543210ZYXWVUTSR","title":"Farmers Market","description":null,"start_at":"2026-03-16T08:00:00Z","end_at":"2026-03-16T13:00:00Z","timezone":"America/Los_Angeles","location_name":"Ferry Building","address":"1 Ferry Building, San Francisco, CA 94111","lat":37.7956,"lng":-122.3933,"url":null,"cost":null,"audience":"all","event_type":"market","created_at":"2026-03-02T09:30:00Z"}],"count":2,"total":45,"next_cursor":"MjAyNi0wMy0xNlQwODowMDowMCswMDowMHwwMUpBUVJTNTY3ODkwMTIzNE1OT1BRUlNU"}},{"step":4,"name":"Update event","method":"PATCH","path":"/v1/events/{event_id}","headers":{"Content-Type":"application/json","X-API-Key":"<your-api-key>"},"curl":"curl -X PATCH https://api.meetspace.events/v1/events/01JAXYZ1234567890ABCDEFGH -H \"Content-Type: application/json\" -H \"X-API-Key: <your-api-key>\" -d '{\"title\":\"Tech Meetup — March Edition\",\"cost\":\"$5\"}'","notes":"Partial update — only include fields you want to change. Send null to clear nullable fields (description, end_at, address, url, cost). You can only update events you created (matched by API key).","request_body":{"title":"Tech Meetup — March Edition","cost":"$5"},"response_example":{"event_id":"01JAXYZ1234567890ABCDEFGH","agent_id":"01JABC9876543210ZYXWVUTSR","title":"Tech Meetup — March Edition","description":"Monthly gathering for local developers to share projects and ideas.","start_at":"2026-03-15T18:00:00Z","end_at":"2026-03-15T20:00:00Z","timezone":"America/Los_Angeles","location_name":"Community Center","address":"123 Main St, San Francisco, CA 94105","lat":37.7749,"lng":-122.4194,"url":null,"cost":"$5","audience":"adults","event_type":"meetup","created_at":"2026-03-01T12:00:00Z"}},{"step":5,"name":"Delete event","method":"DELETE","path":"/v1/events/{event_id}","headers":{"X-API-Key":"<your-api-key>"},"curl":"curl -X DELETE https://api.meetspace.events/v1/events/01JAXYZ1234567890ABCDEFGH -H \"X-API-Key: <your-api-key>\"","notes":"Permanently removes the event. You can only delete events you created. Returns 204 No Content on success.","request_body":null,"response_notes":"204 No Content — no response body on success. 404 if the event does not exist or you do not own it."}],"idempotency":{"applies_to":"POST /v1/events","key":"agent_id + title + start_at + lat + lng","behavior":"If the same agent sends a create request matching all five fields of an existing event, the API returns the existing event (same event_id) with 200. No duplicate is created. If any field in the tuple differs, a new event is created."},"error_codes":[{"code":"MISSING_API_KEY","status":401,"when":"X-API-Key header is not provided.","agent_action":"Add the X-API-Key header. If you don't have a key, call POST /v1/auth/register."},{"code":"INVALID_API_KEY","status":401,"when":"The API key does not match any active key.","agent_action":"Check for typos. If the key was revoked, register a new one."},{"code":"INSUFFICIENT_TIER","status":403,"when":"The API key's tier does not permit this operation (e.g. read-only key on a write endpoint).","agent_action":"Register a new key with the required tier, or contact the API operator."},{"code":"NOT_FOUND","status":404,"when":"The requested event_id does not exist, or you do not own it (for PATCH/DELETE).","agent_action":"Verify the event_id. For PATCH/DELETE, ensure you are using the same API key that created the event."},{"code":"VALIDATION_ERROR","status":422,"when":"Request body or query parameters failed validation (missing fields, bad types, end_at in the past, etc.).","agent_action":"Read the message field for specifics and fix the request."}]}