{"openapi":"3.0.0","servers":[{"description":"tap API server","url":"https://api.tatatap.com/notes/v1"}],"info":{"description":"Note-taking API www.tatatap.com","version":"1.0.0","title":"/tap API","contact":{"email":"hello@tatatap.com"}},"paths":{"/{api_id}":{"get":{"summary":"Retrieves notes","description":"Returns all notes included in the folder associated with the API\n","parameters":[{"in":"path","name":"api_id","description":"The ID associated with your API when first created","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Notes in the API folder","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Note"}}}}},"401":{"description":"not authorized."}}},"post":{"summary":"adds a new note","description":"Adds a note to the system","parameters":[{"in":"path","name":"api_id","description":"The ID associated with your API when first created","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"note created"},"400":{"description":"invalid input"},"401":{"description":"not authorized."}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteRequest"}}},"description":"Note to add"}}},"/{api_id}/{note_id}":{"get":{"summary":"Retrieves a single note","description":"","parameters":[{"in":"path","name":"api_id","description":"The ID associated with your API when first created","required":true,"schema":{"type":"string"}},{"in":"path","name":"note_id","description":"The ID of the note","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"search results matching criteria","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NoteId"}}}}},"401":{"description":"not authorized."}}},"post":{"summary":"update existing note","description":"Update a note in the system","parameters":[{"in":"path","name":"api_id","description":"The ID associated with your API when first created","required":true,"schema":{"type":"string"}},{"in":"path","name":"note_id","description":"The ID of the note","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"note updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteId"}}}},"400":{"description":"invalid input"},"401":{"description":"not authorized."}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteRequest"}}},"description":"Note content to update"}},"delete":{"summary":"delete existing note","description":"Deletes a note in the system","parameters":[{"in":"path","name":"api_id","description":"The ID associated with your API when first created","required":true,"schema":{"type":"string"}},{"in":"path","name":"note_id","description":"The ID of the note","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"note deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteId"}}}},"400":{"description":"invalid input"},"401":{"description":"not authorized."}}}},"/{api_id}/beans":{"get":{"summary":"Retrieves notes","description":"","parameters":[{"in":"path","name":"api_id","description":"The ID associated with your API when first created","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"search results matching criteria","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BeanTotal"}}}}},"401":{"description":"not authorized."}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"NoteRequest":{"type":"object","required":["note"],"properties":{"note":{"type":"string","example":"/folder +bean100 -ok"}}},"Note":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"note_body":{"type":"string"},"folder":{"type":"string"},"date":{"type":"string"},"tags":{"type":"array","items":{"type":"object"}},"events":{"type":"array","items":{"type":"object"}},"beans":{"type":"array","items":{"type":"object"}},"bookmarks":{"type":"array","items":{"type":"object"}},"todo":{"type":"string"},"full_note":{"type":"string"}}},"NoteId":{"type":"object","required":["id"],"properties":{"id":{"type":"string","format":"uuid","example":"d290f1ee-6c54-4b01-90e6-d701748f0851"}}},"BeanTotal":{"type":"object","required":["net","incoming","outgoing"],"properties":{"net":{"type":"number","example":100},"incoming":{"type":"number","example":200},"outgoing":{"type":"number","example":-100},"date":{"type":"string"},"symbol":{"type":"string"}}}}},"security":[{"ApiKeyAuth":[]}]}