{"name":"Deep Tech Week API","version":"4","docs":"https://www.deep-tech-week.com/api/dtw","authentication":{"type":"bearer","header":"Authorization: Bearer dtw_mk_...","description":"API keys are issued by platform admins or org owners. Include your key in the Authorization header as a Bearer token.","key_tiers":{"super-admin":{"conference_id":null,"organization_id":null,"description":"Full access to all conferences and events."},"conference":{"conference_id":"set","organization_id":null,"description":"Scoped to a single conference and its events."},"organization":{"conference_id":null,"organization_id":"set","description":"Scoped to events the org hosts (across all conferences). Also grants access to /api/luma/* proxy."}},"rate_limit":{"dtw_api":{"requests_per_minute":60,"scope":"per API key"},"luma_proxy":{"requests_per_minute":30,"scope":"per organization (org keys only)"},"headers":{"X-RateLimit-Limit":"Max requests per window","X-RateLimit-Remaining":"Remaining requests in current window","X-RateLimit-Reset":"Unix timestamp when the window resets"},"exceeded":"429 Too Many Requests"}},"pagination":{"type":"cursor","description":"All list endpoints use cursor-based pagination. Pass `cursor` from the previous response to get the next page.","query_params":{"cursor":"string — opaque cursor from pagination.next_cursor","limit":"integer — items per page (default 50, max 200)"},"response_shape":{"items":"[...] — array of results","pagination":{"has_more":"boolean","next_cursor":"string | null","count":"number — items in this page"}}},"endpoints":{"ping":{"method":"GET","url":"https://www.deep-tech-week.com/api/dtw/ping","description":"Validate your API key and see key info (name, scope, expiry).","auth":true},"list_conferences":{"method":"GET","url":"https://www.deep-tech-week.com/api/dtw/conferences","description":"List published/approved conferences. Conference-scoped keys only see their conference. Org-scoped keys see conferences where the org hosts events.","auth":true,"query_params":{"cursor":{"type":"string","description":"Pagination cursor"},"limit":{"type":"integer","default":50,"max":200}}},"list_conference_events":{"method":"GET","url":"https://www.deep-tech-week.com/api/dtw/conferences/{id}/events","description":"List approved/published events for a conference. Org-scoped keys only see events the org hosts.","auth":true,"query_params":{"category":{"type":"string","required":false,"enum":["mainline","community","sponsored","vip"],"description":"Filter by event category."},"cursor":{"type":"string","description":"Pagination cursor"},"limit":{"type":"integer","default":50,"max":200}}},"list_posters":{"method":"GET","url":"https://www.deep-tech-week.com/api/dtw/posters","description":"List event posters. Filter by event_id, conference_id, or published status.","auth":true,"query_params":{"event_id":{"type":"uuid","required":false,"description":"Filter by event."},"conference_id":{"type":"uuid","required":false,"description":"Filter by conference. If your key is scoped to a conference, this defaults to that conference."},"published":{"type":"string","required":false,"enum":["true","false"],"description":"Filter by published status. Omit to return all posters."},"cursor":{"type":"string","description":"Pagination cursor"},"limit":{"type":"integer","default":50,"max":200}}},"get_event_posters":{"method":"GET","url":"https://www.deep-tech-week.com/api/dtw/events/{id}/posters","description":"List posters for a specific event.","auth":true,"query_params":{"published":{"type":"string","required":false,"enum":["true","false"],"description":"Filter by published status."},"cursor":{"type":"string","description":"Pagination cursor"},"limit":{"type":"integer","default":50,"max":200}}},"get_poster":{"method":"GET","url":"https://www.deep-tech-week.com/api/dtw/posters/{id}","description":"Get a single poster by ID with full metadata.","auth":true},"update_poster":{"method":"PATCH","url":"https://www.deep-tech-week.com/api/dtw/posters/{id}","description":"Update posted_urls after sharing a poster to social media. Hosts can see these links in their dashboard.","auth":true,"body":{"posted_urls":{"type":"object","required":true,"description":"URLs where the poster was shared. Hosts see these links so they can reshare.","example":{"linkedin":"https://linkedin.com/posts/...","twitter":"https://x.com/..."}}}},"luma_proxy":{"url":"https://www.deep-tech-week.com/api/luma/{luma-path}","description":"Proxy to Luma API. Requires an organization-scoped API key. Supports GET, POST, PUT, PATCH, DELETE. DTW event UUIDs are automatically swapped to Luma event IDs.","auth":true,"key_tier":"organization only","rate_limit":"30 req/min per organization"}},"schemas":{"Conference":{"id":"uuid","name":"string","slug":"string","short_name":"string","description":"string","city":"string","start_date":"date (YYYY-MM-DD)","end_date":"date (YYYY-MM-DD)","timezone":"string (IANA)","status":"string — approved | published","category":"string — mainline | community | vip","banner_thumbnail_url":"string | null","created_at":"timestamp"},"EventSummary":{"id":"uuid","name":"string","start_time":"ISO 8601 timestamp","end_time":"ISO 8601 timestamp","timezone":"string (IANA)","venue":"string | null","venue_address":"string | null","status":"string — approved | published","category":"string — mainline | community | sponsored | vip","tier":"string | null — headline | vip | community","description":"string | null","luma_url":"string | null","tile_image_url":"string | null","conference_id":"uuid","created_at":"timestamp"},"Poster":{"id":"uuid — unique poster ID","event_id":"uuid — the event this poster belongs to","conference_id":"uuid | null — conference the event belongs to","image_url":"string — full-resolution poster image URL","thumbnail_url":"string | null — smaller thumbnail URL","title":"string | null — poster title (event name or speaker name)","published":"boolean — whether the poster is published and visible to attendees","sort_order":"number — display order","metadata":"object — freeform context (style, speakers, generation info)","posted_urls":"object | null — { \"linkedin\": \"url\", \"twitter\": \"url\" } after social sharing","created_at":"timestamp"}},"workflow":{"description":"Recommended agent workflow","steps":["1. GET /api/dtw/ping — verify your key works","2. GET /api/dtw/conferences — discover available conferences","3. GET /api/dtw/conferences/{id}/events — browse events for a conference","4. GET /api/dtw/posters?published=true — fetch published posters","5. Download poster.image_url and post to social media","6. PATCH /api/dtw/posters/{id} with { \"posted_urls\": { \"linkedin\": \"...\", \"twitter\": \"...\" } }","7. Hosts will see your posted_urls in their dashboard and can reshare"]},"deprecated":{"note":"The /api/dtw/marketing/* endpoints are deprecated and return 410 Gone. Use /api/dtw/posters instead.","old_endpoints":["/api/dtw/marketing/content","/api/dtw/marketing/content/{id}","/api/dtw/marketing/queue","/api/dtw/marketing/sync","/api/dtw/events/{id}/marketing"]}}