{"id":19640243,"url":"https://github.com/gearplug/trello-python","last_synced_at":"2026-05-26T16:37:12.756Z","repository":{"id":162302282,"uuid":"636803674","full_name":"GearPlug/trello-python","owner":"GearPlug","description":"trello-python is an API wrapper for Trello, written in Python.","archived":false,"fork":false,"pushed_at":"2023-05-12T16:10:55.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-02-26T22:44:39.720Z","etag":null,"topics":["api","atlassian","boards","cards","management","oauth","project","python","trello","webhooks","workspaces","wrapper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GearPlug.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-05T17:24:37.000Z","updated_at":"2023-05-05T22:08:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"b2802b15-e36a-427f-9cc0-8e8c3ead63c7","html_url":"https://github.com/GearPlug/trello-python","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GearPlug/trello-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GearPlug%2Ftrello-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GearPlug%2Ftrello-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GearPlug%2Ftrello-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GearPlug%2Ftrello-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GearPlug","download_url":"https://codeload.github.com/GearPlug/trello-python/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GearPlug%2Ftrello-python/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33530316,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"ssl_error","status_checked_at":"2026-05-26T15:22:15.568Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","atlassian","boards","cards","management","oauth","project","python","trello","webhooks","workspaces","wrapper"],"created_at":"2024-11-11T14:05:10.398Z","updated_at":"2026-05-26T16:37:12.741Z","avatar_url":"https://github.com/GearPlug.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# trello-python\n![](https://img.shields.io/badge/version-0.1.0-success) ![](https://img.shields.io/badge/Python-3.8%20|%203.9%20|%203.10%20|%203.11-4B8BBE?logo=python\u0026logoColor=white)  \n\n*trello-python* is an API wrapper for Trello, written in Python.  \nThis library uses Oauth2 for authentication and notifications using webhooks.\n## Installing\n```\npip install trello-python\n```\n## Usage\n```python\nfrom trello.client import Client\nclient = Client(api_key, token=None)\n```\nIf you don't have a token, follow this instructions:\n1. **Get authorization URL to obtain token**\n```python\nurl = client.authorization_url(return_url)\n```\n2. **Set access token**\n```python\nclient.set_token(access_token)\n```\nCheck more information about Trello Oauth: https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/\n#### Get current user\n```python\nuser = client.get_current_user()\n```\n### Workspaces\n#### - List Workspaces\n```python\n# filter = One of: all, members, none, public (Note: members filters to only private Workspaces)\n# fields = all or a comma-separated list of organization fields\n# paid_accounts = Whether or not to include paid account information in the returned workspace object  \nworkspace = client.get_workspaces(member_id, filter=None, fields=None, paid_accounts=None)\n```\n#### - List Workspace Members\n```python\nmembers = client.get_members(workspace_id)\n```\n#### - List Workspace boards\n```python\n# filter = One of: all, members, none, public (Note: members filters to only private Workspaces) \\n\n# fields = all or a comma-separated list of organization fields \\n\nboards = client.get_boards(workspace_id, filter=None, fields=None)\n```\n### Boards\n#### Get board\n```python\nboard = client.get_board(board_id)\n```\n#### - List board cards\n```python\n# limit = maximum: 1000\ncards = client.get_cards(board_id, limit=None)\n```\n#### - List board lists\n```python\n# cards = Valid values: all, closed, none, open  \n# filter = Valid values: all, closed, none, open  \n# fields = all or a comma-separated list of list fields\nlists = client.get_board_lists(board_id, cards=None, filter=None, fields=None)\n```\n#### - List board labels\n```python\n# limit = default: 50, maximum: 1000\nlabels = client.get_board_labels(board_id, limit=None)\n```\n#### - Create label\n```python\n# color = Valid values: yellow, purple, blue, red, green, orange, black, sky, pink, lime\nlabel = client.create_label(board_id, name, color=None)\n```\n### Cards\n#### - Create Card\n```python\n# pos: The position of the new card. top, bottom, or a positive float\n# due, start: these params accept only isoformat dates.\n# idMembers, idLabels: string with a list of ids separated by commas.\ncard = client.create_card(\n    idList,\n    name=None, \n    desc=None, \n    pos=None, \n    due=None, \n    start=None, \n    dueComplete=None, \n    idMembers=None, \n    idLabels=None, \n    urlSource=None\n)\n```\n#### - Add label to card\n```python\nlabel = client.add_label_to_card(card_id, label_id)\n```\n#### - Add comment to card\n```python\ncomment = client.add_comment_to_card(card_id, comment_text)\n```\n#### - List card actions\n```python\n# action_type = A comma-separated list of action types. Default: commentCard\nactions = client.get_card_actions(card_id, action_type=None, page=None)\n```\nA list of action types here: https://developer.atlassian.com/cloud/trello/guides/rest-api/action-types/\n#### - List card checklists\n```python\n# fields = all or a comma-separated list of: idBoard,idCard,name,pos\nchecklists = client.get_card_checklists(card_id, fields=None)\n```\n#### - List card custom fields\n```python\ncustom_fields = client.get_card_customfields(card_id)\n```\n#### - Get custom field\n```python\ncustom_field = client.get_customfield(customfield_id)\n```\n### Checklists\n#### - Add item to checklist\n```python\n# pos = The position of the check item in the checklist. One of: top, bottom, or a positive number.\n# due, dueReminder: these params accept only isoformat dates.\nitem = client.add_item_to_checklist(checklist_id, name, pos=None, checked=None, due=None, dueReminder=None, idMember=None)\n```\n### Webhooks\n#### - List token webhooks\n```python\nwebhooks = client.get_token_webhooks()\n```\n#### - Create webhook\n```python\nwebhook = client.create_webhook(idModel, callbackURL, description=None, active=True)\n```\n#### Delete webhook\n```python\nclient.delete_webhook(webhook_id)\n```\n### Search\n```python\n# modelTypes = all or a comma-separated list of: actions, boards, cards, members, organizations. Default all.\n# partial = true means that it will look for content that starts with any of the words in your query\nsearch = client.search(query, modelTypes=None, partial=None)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgearplug%2Ftrello-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgearplug%2Ftrello-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgearplug%2Ftrello-python/lists"}